SNMP-Funktionen

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

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

API-Funktionen des SNMP-Erweiterungs-Agents

Die Funktionen des SNMP-Erweiterungs-Agents 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 Variablenbindungen auflösen können, die von eingehenden SNMP-Protokolldateneinheiten (PDUs) angegeben werden.

API-Funktion des SNMP-Erweiterungs-Agents BESCHREIBUNG
SnmpExtensionClose Fordert an, dass der SNMP-Erweiterungs-Agent die Ressourcen zu einem anderen Konto befindt und Vorgänge beendet.
SnmpExtensionInit Initialisiert die DLL des SNMP-Erweiterungs-Agents.
SnmpExtensionInitEx Identifiziert alle zusätzlichen MIB-Teilstruktur (Management Information Base), die der SNMP-Erweiterungs-Agent unterstützt.
SnmpExtensionMonitor Stellt dem SNMP-Erweiterungs-Agent Informationen zu den internen Leistungsindikatoren und Parametern des Diensts zur Verfügung.
SnmpExtensionQuery Löst SNMP-Anforderungen auf, die Variablen in einer oder mehr der registrierten MIB-Teilstruktur des SNMP-Erweiterungs-Agents enthalten.
SnmpExtensionQueryEx Verarbeitet SNMP-Anforderungen, die Variablen in mindestens einer MIB-Teilstruktur 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 DLL-Mgmtapi.dll. Die DLL funktioniert in Verbindung mit dem SNMP-Trapdienst (Snmptrap.exe) und kann mit einer oder mehrere SNMP-Manager-Anwendungen von Drittanbietern interagieren. In der folgenden Tabelle sind die Verwaltungsfunktionen aufgeführt, die Manager-Anwendungen von Drittanbietern zum Ausführen von SNMP-Managervorgängen verwenden.

SNMP-Verwaltungs-API Funktion BESCHREIBUNG
SnmpMgrClose Schließt die Kommunikationssockes 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 Trapempfang aktiviert ist.
SnmpMgrGetTrapEx Gibt ausstehende Trapdaten zurück, die der Aufrufer nicht empfangen hat, wenn der Trapempfang aktiviert ist. Gibt auch die Adresse der Transportquelle und den Community-Trap zurück, der 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 seine interne Objektbezeichnerstruktur.
SnmpMgrTrapListen Registriert die Fähigkeit einer SNMP-Manager-Anwendung, SNMP-Traps vom SNMP-Trapdienst zu empfangen.

API-Funktionen des SNMP-Hilfsprogramms

Die SNMP-Hilfsfunktionen 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 Funktionen des SNMP-Hilfsprogramms aufgeführt.

API-Funktion des SNMP-Hilfsprogramms BESCHREIBUNG
SnmpSvcGetUptime Ruft die Zeit in Millisekunden ab, für die der SNMP-Dienst ausgeführt wurde.
SnmpSvcSetLogLevel Passt die Detailebene der Debugausgabe des SNMP-Diensts und der 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 zugeordnet 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 (OID) in eine auf NULL beendete Zeichenfolge.
SnmpUtilMemAlloc Weist dynamischen Arbeitsspeicher aus dem Prozesshap 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 zugeordnet 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 AsnObjectIdentifier-Quellstruktur in eine AsnObjectIdentifier-Zielstruktur.
SnmpUtilOidFree Gibt den Arbeitsspeicher frei, der für den angegebenen Objektbezeichner zugeordnet wurde.
SnmpUtilOidNCmp Vergleicht zwei Objektbezeichner, die in AsnObjectIdentifier-Strukturen enthalten sind, mit der angegebenen Anzahl von Unteridentifizierern.
SnmpUtilOidToA Konvertiert einen Objektbezeichner (OID) in eine auf NULL beendete Zeichenfolge.
SnmpUtilPrintAsnAny Gibt einen Wert aus, der zu Debug- und Entwicklungszwecken in einer AsnAny-Struktur enthalten ist.
SnmpUtilPrintOid Formatiert den angegebenen Objektbezeichner (OID) und gibt das Ergebnis auf dem 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 zugeordnet wurde.
SnmpUtilVarBindListFree Gibt den Arbeitsspeicher frei, der für die angegebene SnmpVarBindList-Struktur zugeordnet wurde.