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
- SNMP-Verwaltungs-API Funktionen
- API-Funktionen des SNMP-Hilfsprogramms
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. |