Freigeben über

SNMP-Funktionen

  • Artikel

[SNMP steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Verwenden Sie stattdessen Windows Remote Management, was die Microsoft-Implementierung von WS-Man ist.]

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

SNMP-Erweiterungs-Agent-API-Funktionen

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

SNMP-Erweiterungs-Agent-API-Funktion Beschreibung
SnmpExtensionClose Fordert an, dass der SNMP-Erweiterungs-Agent Ressourcen verwechselt und Vorgänge beendet.
SnmpExtensionInit Initialisiert die SNMP-Erweiterungs-Agent-DLL.
SnmpExtensionInitEx Identifiziert alle zusätzlichen MIB-Unterstrukturen (Management Information Base), die der SNMP-Erweiterungs-Agent unterstützt.
SnmpExtensionMonitor Stellt den SNMP-Erweiterungs-Agent Informationen zu den internen Zählern und Parametern des Diensts bereit.
SnmpExtensionQuery Löst SNMP-Anforderungen, die Variablen in einer oder mehreren registrierten MIB-Unterstrukturen des SNMP-Erweiterungs-Agents enthalten.
SnmpExtensionQueryEx 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 arbeitet in Verbindung mit dem SNMP Trap Service (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-Manageranwendungen 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 Anrufer nicht empfangen hat, wenn der Trapempfang aktiviert ist.
SnmpMgrGetTrapEx Gibt ausstehende Trapdaten zurück, die der Anrufer nicht empfangen hat, wenn der Trapempfang aktiviert ist. Gibt auch die Adresse der Transportquelle und der Community-Trap zurück, die mit der Falle verknüpft ist.
SnmpMgrOidToStr Konvertiert eine interne Objektbezeichnerstruktur in die 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 Service zu empfangen.

 

SNMP-Hilfsprogramm-API-Funktionen

Die SNMP-Hilfsfunktionen bieten Funktionen, die bei der Entwicklung von SNMP-Anwendungen nützlich sind, einschließlich der Vereinfachung der Manipulation von SNMP-Datenstrukturen. In der folgenden Tabelle sind die SNMP-Hilfsfunktionen 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 die Detailebene der Debugausgabe des SNMP-Diensts und von SNMP-Erweiterungs-Agents an.
SnmpSvcSetLogType Passt das Ziel für die Debugausgabe des SNMP-Diensts und von SNMP-Erweiterungs-Agents an.
SnmpUtilAsnAnyCpy Kopiert eine Quellstruktur AsnAny struktur in eine Zielstruktur AsnAny.
SnmpUtilAsnAnyFree Gibt den Speicher 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 SnmpUtilDbgPrintempfangen werden sollen.
SnmpUtilIdsToA- Konvertiert einen Objektbezeichner (OID) in eine mit Null beendete Zeichenfolge.
SnmpUtilMemAlloc- Weist dem Prozesshap dynamischen Speicher zu.
SnmpUtilMemFree- Gibt das angegebene Speicherobjekt frei.
SnmpUtilMemReAlloc Ändert die Größe des angegebenen Speicherobjekts.
SnmpUtilOctetsCmp- Vergleicht zwei Oktettzeichenfolgen.
SnmpUtilOctetsCpy Kopiert eine AsnOctetString- Struktur in eine Zielstruktur AsnOctetString Struktur.
SnmpUtilOctetsFree Gibt den Speicher frei, der für die angegebene Oktettzeichenfolge zugewiesen wurde.
SnmpUtilOctetsNCmp- Führt einen Vergleich von zwei Oktettzeichenfolgen mit der angegebenen Anzahl von Unteridentifizierern aus.
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 Quelle AsnObjectIdentifier Struktur in eine Zielstruktur AsnObjectIdentifier Struktur.
SnmpUtilOidFree Gibt den Speicher 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 (OID) in eine mit Null beendete Zeichenfolge.
SnmpUtilPrintAsnAny Druckt einen Wert, der in einer AsnAny- Struktur für Debugging- und Entwicklungszwecke enthalten ist.
SnmpUtilPrintOid- Formatiert den angegebenen Objektbezeichner (OID) und druckt das Ergebnis auf das Standardausgabegerät.
SnmpUtilVarBindCpy Kopiert eine Quelle SnmpVarBind Struktur in eine Zielstruktur SnmpVarBind Struktur.
SnmpUtilVarBindListCpy Kopiert eine Quelle SnmpVarBindList- Struktur in eine Zielstruktur SnmpVarBindList Struktur.
SnmpUtilVarBindFree Gibt den Speicher frei, der für die angegebene SnmpVarBind Struktur zugeordnet wurde.
SnmpUtilVarBindListFree Gibt den Speicher frei, der für die angegebene SnmpVarBindList Struktur zugewiesen wurde.