Dela via

SNMP-funktioner

  • Artikel

[SNMP är tillgängligt för användning i de operativsystem som anges i avsnittet Krav. Den kan ändras eller vara otillgänglig i efterföljande versioner. Använd i stället Windows Remote Management, som är Microsoft-implementeringen av WS-Man.]

Det här avsnittet beskriver tre grupper av SNMP-funktioner och listar de funktioner som ingår i varje grupp:

API-funktioner för SNMP-tilläggsagent

SNMP-tilläggsagentfunktionerna definierar gränssnittet mellan SNMP-tjänsten och SNMP-tilläggsagentens DLL:er från tredje part. I följande tabell visas funktioner som program kan använda för att lösa variabelbindningar som anges av inkommande SNMP-protokolldataenheter (PDUs).

API-funktion för SNMP-tilläggsagent Beskrivning
SnmpExtensionClose Begär att SNMP-tilläggsagenten frigör resurser och avslutar åtgärder.
SnmpExtensionInit Initierar SNMP-tilläggsagentens DLL.
SnmpExtensionInitEx Identifierar eventuella ytterligare underträd för hanteringsinformationsbasen (MIB) som SNMP-tilläggsagenten stöder.
SnmpExtensionMonitor Ger SNMP-tilläggsagenten information om tjänstens interna räknare och parametrar.
SnmpExtensionQuery Löser SNMP-begäranden som innehåller variabler i en eller flera av de registrerade MIB-underträden för SNMP-tilläggsagenten.
SnmpExtensionQueryEx Bearbetar SNMP-begäranden som anger variabler i ett eller flera MIB-underträd som registreras av SNMP-tilläggsagenter.
SnmpExtensionTrap Hämtar information som tjänsten kräver för att generera traps för SNMP-tilläggsagenten.

 

SNMP Management API Functions

SNMP-hanteringsfunktionerna definierar gränssnittet mellan SNMP Manager-program från tredje part och DLL-Mgmtapi.dll(hanteringsfunktionen dynamic-link library). DLL fungerar tillsammans med SNMP-traptjänsten (Snmptrap.exe) och kan interagera med ett eller flera SNMP-hanteringsprogram från tredje part. I följande tabell visas de hanteringsfunktioner som program från tredje part använder för att utföra SNMP Manager-åtgärder.

SNMP Management API-funktion Beskrivning
SnmpMgrClose Stänger kommunikations sockets och datastrukturer som är associerade med den angivna sessionen.
SnmpMgrCtl Anger en driftparameter som är associerad med en SNMP-session.
SnmpMgrGetTrap Returnerar utestående trap-data som anroparen inte har tagit emot om trap-mottagningen är aktiverad.
SnmpMgrGetTrapEx Returnerar utestående trap-data som anroparen inte har tagit emot om trap-mottagningen är aktiverad. Returnerar också adressen för transportkällan och den community-trap som är associerad med trapen.
SnmpMgrOidToStr Konverterar en intern objektidentifierarstruktur till dess strängrepresentation.
SnmpMgrOpen Initierar kommunikations sockets och datastrukturer som krävs för att upprätta kommunikation med SNMP-agenten.
SnmpMgrRequest Begär att den angivna åtgärden ska utföras av den angivna agenten.
SnmpMgrStrToOid Konverterar strängformatet för en objektidentifierare till dess interna objektidentifierarstruktur.
SnmpMgrTrapListen Registrerar möjligheten för ett SNMP Manager-program att ta emot SNMP-traps från SNMP Trap Service.

 

API-funktioner för SNMP-verktyg

SNMP-verktygsfunktionerna ger funktioner som är användbara under utvecklingen av SNMP-program, inklusive att förenkla manipuleringen av SNMP-datastrukturer. I följande tabell visas funktionerna för SNMP-verktyget.

API-funktion för SNMP-verktyg Beskrivning
SnmpSvcGetUptime Hämtar den tid i centisekunder som SNMP-tjänsten har körts för.
SnmpSvcSetLogLevel Justerar detaljnivån för felsökningsutdata från SNMP-tjänsten och från SNMP-tilläggsagenter.
SnmpSvcSetLogType Justerar målet för felsökningsutdata från SNMP-tjänsten och från SNMP-tilläggsagenter.
SnmpUtilAsnAnyCpy Kopierar en AsnAny- struktur till en målstruktur AsnAny struktur.
SnmpUtilAsnAnyFree Frigör det minne som allokerades för en angiven AsnAny- struktur.
SnmpUtilDbgPrint Anger nivån för felsökningsinformation som ska tas emot från SNMP-tjänsten eller från ett anrop till SnmpUtilDbgPrint-.
SnmpUtilIdsToA Konverterar en objektidentifierare (OID) till en null-avslutad sträng.
SnmpUtilMemAlloc Allokerar dynamiskt minne från processhögen.
SnmpUtilMemFree Frigör det angivna minnesobjektet.
SnmpUtilMemReAlloc Ändrar storleken på det angivna minnesobjektet.
SnmpUtilOctetsCmp Jämför två oktettsträngar.
SnmpUtilOctetsCpy Kopierar en källa AsnOctetString struktur till en målstruktur AsnOctetString struktur.
SnmpUtilOctetsFree Frigör det minne som allokerades för den angivna oktettsträngen.
SnmpUtilOctetsNCmp Utför en jämförelse av två oktettsträngar med det angivna antalet underidentifierare.
SnmpUtilOidAppend Lägger till en källobjektidentifierare, som finns i en AsnObjectIdentifier struktur, till en målobjektidentifierare.
SnmpUtilOidCmp Jämför två objektidentifierare som finns i AsnObjectIdentifier strukturer.
SnmpUtilOidCpy Kopierar en källa AsnObjectIdentifier struktur till en målstruktur AsnObjectIdentifier struktur.
SnmpUtilOidFree Frigör det minne som allokerades för den angivna objektidentifieraren.
SnmpUtilOidNCmp Jämför två objektidentifierare som finns i AsnObjectIdentifier strukturer med det angivna antalet underidentifierare.
SnmpUtilOidToA Konverterar en objektidentifierare (OID) till en null-avslutad sträng.
SnmpUtilPrintAsnAny Skriver ut ett värde som finns i en AsnAny- struktur för felsökning och utveckling.
SnmpUtilPrintOid Formaterar den angivna objektidentifieraren (OID) och skriver ut resultatet till standardutdataenheten.
SnmpUtilVarBindCpy Kopierar en SnmpVarBind- struktur till en målstruktur SnmpVarBind struktur.
SnmpUtilVarBindListCpy Kopierar en SnmpVarBindList- struktur till en målstruktur SnmpVarBindList struktur.
SnmpUtilVarBindFree Frigör det minne som allokerades för den angivna SnmpVarBind- struktur.
SnmpUtilVarBindListFree Frigör det minne som allokerades för den angivna SnmpVarBindList- struktur.