SNMP-Funktionen

  • Artikel

[SNMP ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]

In diesem Thema werden drei Gruppierungen von SNMP-Funktionen beschrieben und die Funktionen aufgelistet, die in jeder Gruppe enthalten sind:

API-Funktionen des SNMP-Erweiterungs-Agents

Die SNMP-Erweiterungs-Agent-Funktionen definieren die Schnittstelle zwischen dem SNMP-Dienst und den SNMP-Erweiterungs-Agent-DLLs von Drittanbietern. In der folgenden Tabelle sind Funktionen aufgeführt, die Anwendungen verwenden können, um variablen Bindungen aufzulösen, die von eingehenden SNMP-Protokolldateneinheiten (PDUs) angegeben werden.

SNMP-Erweiterungs-Agent-API-Funktion BESCHREIBUNG
SnmpExtensionClose Fordert an, dass der SNMP-Erweiterungs-Agent Ressourcen zugeordnet und Vorgänge beendet.
SnmpExtensionInit Initialisiert die DLL des SNMP-Erweiterungs-Agents.
SnmpExtensionInitEx Identifiziert alle zusätzlichen MIB-Unterstrukturen (Management Information Base), die vom SNMP-Erweiterungs-Agent unterstützt werden.
SnmpExtensionMonitor Stellt dem SNMP-Erweiterungs-Agent Informationen zu den internen Leistungsindikatoren und Parametern des Diensts bereit.
SnmpExtensionQuery Löst SNMP-Anforderungen, die Variablen in mindestens einer der registrierten MIB-Unterstrukturen des SNMP-Erweiterungs-Agents enthalten.
SnmpExtensionQueryExtensionQueryEx Verarbeitet SNMP-Anforderungen, die Variablen in einer oder mehreren MIB-Unterstrukturen angeben, die von SNMP-Erweiterungs-Agents registriert werden.
SnmpExtensionTrap Ruft Informationen ab, die der Dienst zum Generieren von Traps für den SNMP-Erweiterungs-Agent benötigt.

 

SNMP-Verwaltungs-API-Funktionen

Die SNMP-Verwaltungsfunktionen definieren die Schnittstelle zwischen SNMP-Manager-Anwendungen von Drittanbietern und der verwaltungsfunktion dynamic-link library (DLL) Mgmtapi.dll. Die DLL funktioniert in Verbindung mit dem SNMP-Trapdienst (Snmptrap.exe) und kann mit einer oder mehreren SNMP-Manager-Anwendungen von Drittanbietern interagieren. In der folgenden Tabelle sind die Verwaltungsfunktionen aufgeführt, die Von Drittanbieter-Manager-Anwendungen zum Ausführen von SNMP-Manager-Vorgängen verwendet werden.

SNMP-Verwaltungs-API-Funktion BESCHREIBUNG
SnmpMgrClose Schließt die Kommunikationssockets und Datenstrukturen, die der angegebenen Sitzung zugeordnet sind.
SnmpMgrCtl Legt einen Betriebsparameter fest, der einer SNMP-Sitzung zugeordnet ist.
SnmpMgrGetTrap Gibt ausstehende Trapdaten zurück, die der Aufrufer nicht empfangen hat, wenn der Trap-Empfang aktiviert ist.
SnmpMgrGetTrapEx Gibt ausstehende Trapdaten zurück, die der Aufrufer nicht empfangen hat, wenn der Trap-Empfang aktiviert ist. Gibt auch die Adresse der Transportquelle und der Community-Trap zurück, die dem Trap zugeordnet ist.
SnmpMgrOidToStr Konvertiert eine interne Objektbezeichnerstruktur in ihre Zeichenfolgendarstellung.
SnmpMgrOpen Initialisiert Kommunikationssockets und Datenstrukturen, die zum Herstellen der Kommunikation mit dem SNMP-Agent erforderlich sind.
SnmpMgrRequest Fordert an, dass der angegebene Vorgang vom angegebenen Agent ausgeführt wird.
SnmpMgrStrToOid Konvertiert das Zeichenfolgenformat eines Objektbezeichners in die interne Objektbezeichnerstruktur.
SnmpMgrTrapListen Registriert die Fähigkeit einer SNMP-Manager-Anwendung, SNMP-Traps vom SNMP-Trap-Dienst zu empfangen.

 

SNMP-Hilfsprogramm-API-Funktionen

Die SNMP-Hilfsprogrammfunktionen bieten Funktionen, die bei der Entwicklung von SNMP-Anwendungen nützlich sind, einschließlich der Vereinfachung der Bearbeitung von SNMP-Datenstrukturen. In der folgenden Tabelle sind die SNMP-Hilfsprogrammfunktionen aufgeführt.

SNMP-Hilfsprogramm-API-Funktion BESCHREIBUNG
SnmpSvcGetUptime Ruft die Zeit in Centisekunden ab, für die der SNMP-Dienst ausgeführt wurde.
SnmpSvcSetLogLevel Passt den Detailgrad der Debugausgabe vom SNMP-Dienst und von SNMP-Erweiterungs-Agents an.
SnmpSvcSetLogType Passt das Ziel für die Debugausgabe des SNMP-Diensts und der SNMP-Erweiterungs-Agents an.
SnmpUtilAsnAnyCpy Kopiert eine AsnAny-Quellstruktur in eine AsnAny-Zielstruktur .
SnmpUtilAsnAnyFree Gibt den Arbeitsspeicher frei, der für eine angegebene AsnAny-Struktur zugewiesen wurde.
SnmpUtilDbgPrint Legt die Ebene der Debuginformationen fest, die vom SNMP-Dienst oder von einem Aufruf von SnmpUtilDbgPrint empfangen werden sollen.
SnmpUtilIdsToA Konvertiert einen Objektbezeichner (Object Identifier, OID) in eine NULL-Zeichenfolge.
SnmpUtilMemAlloc Ordnet dynamischen Arbeitsspeicher aus dem Prozessheap zu.
SnmpUtilMemFree Gibt das angegebene Speicherobjekt frei.
SnmpUtilMemReAlloc Ändert die Größe des angegebenen Speicherobjekts.
SnmpUtilOctetsCmp Vergleicht zwei Oktettzeichenfolgen.
SnmpUtilOctetsCpy Kopiert eine AsnOctetString-Quellstruktur in eine AsnOctetString-Zielstruktur .
SnmpUtilOctetsFree Gibt den Arbeitsspeicher frei, der für die angegebene Oktettzeichenfolge zugewiesen wurde.
SnmpUtilOctetsNCmp Führt einen Vergleich von zwei Oktettzeichenfolgen mit der angegebenen Anzahl von Unteridentifizierern durch.
SnmpUtilOidAppend Fügt einen Quellobjektbezeichner, der in einer AsnObjectIdentifier-Struktur enthalten ist, an einen Zielobjektbezeichner an.
SnmpUtilOidCmp Vergleicht zwei Objektbezeichner, die in AsnObjectIdentifier-Strukturen enthalten sind.
SnmpUtilOidCpy Kopiert eine AsnObjectIdentifier-Quellstruktur in eine AsnObjectIdentifier-Zielstruktur .
SnmpUtilOidFree Gibt den Arbeitsspeicher frei, der für den angegebenen Objektbezeichner zugewiesen wurde.
SnmpUtilOidNCmp Vergleicht zwei Objektbezeichner, die in AsnObjectIdentifier-Strukturen enthalten sind, mit der angegebenen Anzahl von Unteridentifizierern.
SnmpUtilOidToA Konvertiert einen Objektbezeichner (Object Identifier, OID) in eine NULL-Zeichenfolge.
SnmpUtilPrintAsnAny Gibt einen Wert aus, der in einer AsnAny-Struktur zu Debug- und Entwicklungszwecken enthalten ist.
SnmpUtilPrintOid Formatiert den angegebenen Objektbezeichner (Object Identifier, OID) und gibt das Ergebnis an das Standardausgabegerät aus.
SnmpUtilVarBindCpy Kopiert eine SnmpVarBind-Quellstruktur in eine SnmpVarBind-Zielstruktur .
SnmpUtilVarBindListCpy Kopiert eine SnmpVarBindList-Quellstruktur in eine SnmpVarBindList-Zielstruktur .
SnmpUtilVarBindFree Gibt den Arbeitsspeicher frei, der für die angegebene SnmpVarBind-Struktur zugewiesen wurde.
SnmpUtilVarBindListFree Gibt den Arbeitsspeicher frei, der für die angegebene SnmpVarBindList-Struktur zugewiesen wurde.