WinSNMP-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.]

Die mit WinSNMP verwendeten Funktionen werden in die folgenden Funktionsgruppierungen unterteilt. Es folgt eine alphabetische Liste.

WinSNMP-Kommunikationsfunktionen

Die WinSNMP-Kommunikationsfunktionen stellen eine Schnittstelle zwischen der aufrufenden WinSNMP-Anwendung und der Microsoft WinSNMP-Implementierung bereit. Die Implementierung übernimmt die Kommunikation zwischen der Anwendung und anderen Verwaltungsentitäten.

Funktion BESCHREIBUNG
SnmpCancelMsg Fordert an, dass die Microsoft WinSNMP-Implementierung Wiederholungsversuche und Timeoutbenachrichtigungen für eine SNMP-Anforderungsnachricht abbricht.
SnmpCleanup Informiert die Implementierung darüber, dass eine Anwendung die Verbindung trennt und keine zugeordneten Ressourcen mehr benötigt.
SnmpCleanupEx Führt eine Bereinigung durch, wenn es keine ausstehenden erfolgreichen Aufrufe von SnmpStartup oder SnmpStartupEx in einer WinSNMP-Anwendung gibt.
SnmpClose Ermöglicht der Implementierung die Zuordnung von Ressourcen, die einer Sitzung zugeordnet sind, und das Schließen von Kommunikationsmechanismen.
SnmpCreateSession Fordert die Implementierung auf, eine WinSNMP-Sitzung zu öffnen und Ressourcen und Kommunikationsmechanismen zuzuweisen. Beim Entwickeln neuer WinSNMP-Anwendungen wird empfohlen, die SnmpCreateSession-Funktion aufzurufen, um eine WinSNMP-Sitzung zu öffnen, anstatt die SnmpOpen-Funktion aufzurufen.
SnmpListen Registriert oder hebt die Registrierung einer WinSNMP-Anwendung als SNMP-Agent auf.
SnmpOpen Fordert die Implementierung auf, eine WinSNMP-Sitzung zu öffnen und Ressourcen und Kommunikationsmechanismen zuzuweisen. Beim Entwickeln neuer WinSNMP-Anwendungen wird empfohlen, die SnmpCreateSession-Funktion aufzurufen, um eine WinSNMP-Sitzung zu öffnen, anstatt die SnmpOpen-Funktion aufzurufen.
SnmpRecvMsg Gibt SNMP-Nachrichten und ausstehende Trapdaten und Benachrichtigungen zurück.
SnmpRegister Informiert die Implementierung darüber, dass die Anwendung die Registrierung für Traps und Benachrichtigungen registrieren oder aufheben muss.
SnmpSendMsg Fordert an, dass die Implementierung eine Protokolldateneinheit überträgt.
SnmpStartup Benachrichtigt die Implementierung, Initialisierungsverfahren für die Anwendung auszuführen. Eine Anwendung muss die SnmpStartup-Funktion erfolgreich aufrufen, bevor sie eine andere WinSNMP-Funktion aufruft.
SnmpStartupEx Benachrichtigt die Microsoft WinSNMP-Implementierung, dass die WinSNMP-Anwendung die Dienste der Implementierung erfordert. SnmpStartupEx ermöglicht die Unterstützung für mehrere unabhängige Softwaremodule, die WinSNMP innerhalb derselben Anwendung verwenden.
SNMPAPI_CALLBACK Benachrichtigt eine WinSNMP-Sitzung, dass eine SNMP-Nachricht oder ein asynchrones Ereignis verfügbar ist. Hinweis: Diese Rückruffunktion gilt nur für Sitzungen, die infolge eines Aufrufs der SnmpCreateSession-Funktion geöffnet wurden.

WinSNMP-Entitäts- und Kontextfunktionen

Die WinSNMP-Entität und -Kontextfunktionen ermöglichen es einer WinSNMP-Anwendung, benutzerfreundliche Namen für SNMP-Entitäten und -Kontexte anzugeben. Die Microsoft WinSNMP-Implementierung übersetzt den Namen mithilfe der Datenbank der Implementierung in ihre SNMPv1- oder SNMPv2C-Komponenten.

Funktion BESCHREIBUNG
SnmpContextToStr Gibt eine Zeichenfolge zurück, die einen SNMP-Kontext (eine Gruppe verwalteter Objektressourcen) identifiziert.
SnmpEntityToStr Gibt eine Zeichenfolge zurück, die eine SNMP-Verwaltungsentität identifiziert.
SnmpFreeContext Gibt Ressourcen frei, die von der SnmpStrToContext-Funktion für einen SNMP-Kontext zugewiesen wurden.
SnmpFreeEntity Gibt Ressourcen frei, die von der SnmpStrToEntity-Funktion für eine SNMP-Verwaltungsentität zugewiesen wurden.
SnmpSetPort Ändert den Port, der einer SNMP-Zielentität zugewiesen ist.
SnmpStrToContext Gibt ein Handle für SNMP-Kontextinformationen zurück, das für die Implementierung spezifisch ist.
SnmpStrToEntity Gibt ein Handle für SNMP-Verwaltungsentitätsinformationen zurück, das für die Implementierung spezifisch ist.

WinSNMP-Datenbankfunktionen

Die WinSNMP-Datenbankfunktionen bieten einer WinSNMP-Anwendung Zugriff auf die aktuellen Einstellungen im Speicher der Microsoft WinSNMP-Implementierung mit Administrativen Informationen. Diese Funktionen ermöglichen das Ändern des Erneutübertragungsmodus und des Entitäts- und Kontextübersetzungsmodus. Die Datenbankfunktionen bieten der Anwendung auch die Möglichkeit, die Timeout- und Wiederholungsanzahlwerte zu ändern.

Funktion BESCHREIBUNG
SnmpGetRetransmitMode Gibt die aktuelle Einstellung des Erneutübertragungsmodus zurück.
SnmpGetRetry Gibt den Wert der Wiederholungsanzahl in Einheiten für die erneute Übertragung von SNMP-Nachrichtenanforderungen zurück.
SnmpGetTimeout Gibt den Timeoutwert in hundertstel Sekunden für die Übertragung von SNMP-Nachrichtenanforderungen zurück.
SnmpGetTranslateMode Gibt die aktuelle Einstellung des Entitäts- und Kontextübersetzungsmodus zurück.
SnmpGetVendorInfo Ruft Informationen ab, die den WinSNMP-Anbieter identifizieren.
SnmpSetRetransmitMode Ändert den Erneutübertragungsmodus.
SnmpSetRetry Ändert den Wert der Wiederholungsanzahl für die erneute Übertragung von SNMP-Nachrichtenanforderungen.
SnmpSetTimeout Ändert den Timeoutwert für die Übertragung von SNMP-Nachrichtenanforderungen.
SnmpSetTranslateMode Ändert den Entitäts- und Kontextübersetzungsmodus.

WinSNMP PDU-Funktionen

Mit den WinSNMP-PDU-Funktionen können WinSNMP-Anwendungen die Datenelemente (oder Felder) einer PDU extrahieren und aktualisieren. Dies schließt PDUs ein, die durch einen Aufruf der SnmpRecvMsg-Funktion oder der SnmpDecodeMsg-Funktion zurückgegeben werden. Die PDU-Funktionen erstellen auch PDUs für die Verwendung in den Funktionen SnmpSendMsg und SnmpEncodeMsg .

Funktion BESCHREIBUNG
SnmpCreatePdu Erstellt und initialisiert eine SNMP-Protokolldateneinheit.
SnmpDuplicatePdu Dupliziert eine SNMP-Protokolldateneinheit.
SnmpFreePdu Gibt Ressourcen frei, die einer SNMP-Protokolldateneinheit zugeordnet sind, die von der SnmpCreatePdu-Funktion oder der SnmpDuplicatePdu-Funktion erstellt wurde.
SnmpGetPduData Gibt ausgewählte Datenelemente aus einer angegebenen SNMP-Protokolldateneinheit zurück.
SnmpSetPduData Updates ausgewählte Datenelemente in einer angegebenen SNMP-Protokolldateneinheit.

WinSNMP-Hilfsprogrammfunktionen

Die WinSNMP-Hilfsprogrammfunktionen ermöglichen es einer WinSNMP-Anwendung, Objekte und SNMP-Nachrichten über die WinSNMP-Schnittstelle zu verwalten.

Funktion BESCHREIBUNG
SnmpDecodeMsg Decodiert eine codierte oder serialisierte SNMP-Nachricht in ihre komponenten.
SnmpEncodeMsg Erstellt eine codierte SNMP-Nachricht.
SnmpFreeDescriptor Signalisiert der Microsoft WinSNMP-Implementierung, dass sie den Speicher freigeben soll, den sie für einen bestimmten Deskriptor zugewiesen hat.
SnmpGetLastError Gibt den Codewert des letzten Fehlers für den letzten SNMP-Vorgang zurück.
SnmpOidCompare Vergleicht zwei SNMP-Objektbezeichner.
SnmpOidCopy Kopiert einen SNMP-Objektbezeichner.
SnmpOidToStr Konvertiert die interne binäre Darstellung eines SNMP-Objektbezeichners in das numerische Zeichenfolgenformat mit Gepunktet.
SnmpStrToOid Konvertiert das gepunktete numerische Zeichenfolgenformat eines SNMP-Objektbezeichners in die interne binäre Darstellung.

WinSNMP-Variablenbindungsfunktionen

Mit den WinSNMP-Variablenbindungsfunktionen können WinSNMP-Anwendungen Variablenbindungslisten erstellen und bearbeiten und diese in PDUs einschließen.

Funktion BESCHREIBUNG
SnmpCountVbl Listet die Variablenbindungseinträge in einer angegebenen Variablenbindungsliste auf.
SnmpCreateVbl Erstellt eine neue Variablenbindungsliste.
SnmpDeleteVb Entfernt einen Variablenbindungseintrag aus einer Variablenbindungsliste.
SnmpDuplicateVbl Kopiert eine Variablenbindungsliste.
SnmpFreeVbl Gibt Ressourcen für eine Variablenbindungsliste frei, die zuvor von der SnmpCreateVbl-Funktion oder der SnmpDuplicateVbl-Funktion zugeordnet wurde.
SnmpGetVb Ruft Informationen aus einem angegebenen Variablenbindungseintrag ab.
SnmpSetVb Ändert Variablenbindungseinträge in einer Variablenbindungsliste; fügt neue Variablenbindungseinträge an eine vorhandene Variablenbindungsliste an.

Alphabetische Liste der WinSNMP-Funktionen