winsnmp.h-Header

Dieser Header wird vom Simple Network Management Protocol verwendet. Weitere Informationen finden Sie unter

• Simple Network Management-Protokoll

winsnmp.h enthält die folgenden Programmierschnittstellen:

Functions

SnmpCancelMsg Eine WinSNMP-Anwendung ruft die SnmpCancelMsg-Funktion auf, um anzufordern, dass die Microsoft WinSNMP-Implementierung Wiederholungsversuche und Timeoutbenachrichtigungen für eine SNMP-Anforderungsnachricht abbricht.
SnmpCleanup Die SnmpCleanup-Funktion informiert die Microsoft WinSNMP-Implementierung darüber, dass die aufrufende WinSNMP-Anwendung die Dienste der Implementierung nicht mehr benötigt.
SnmpCleanupEx Die SnmpCleanupEx-Funktion führt eine Bereinigung durch, wenn keine ausstehenden erfolgreichen Aufrufe von SnmpStartup oder SnmpStartupEx in einer Windows SNMP-Anwendung (WinSNMP) ausstehen.
SnmpClose Die SnmpClose-Funktion ermöglicht der Microsoft WinSNMP-Implementierung die Zuordnung von Arbeitsspeicher, Ressourcen und Datenstrukturen, die einer WinSNMP-Sitzung zugeordnet sind.
SnmpContextToStr Die WinSNMP SnmpContextToStr-Funktion gibt eine Zeichenfolge zurück, die einen SNMP-Kontext identifiziert, bei dem es sich um eine Gruppe verwalteter Objektressourcen handelt. Die Funktion gibt die Zeichenfolge in einer smiOCTETS-Struktur zurück.
SnmpCountVbl Eine WinSNMP-Anwendung ruft die WinSNMP-Funktion SnmpCountVbl auf, um die Variablenbindungseinträge in der angegebenen Variablenbindungsliste aufzulisten.
SnmpCreatePdu Die WinSNMP SnmpCreatePdu-Funktion erstellt und initialisiert eine SNMP-Protokolldateneinheit (PDU).
SnmpCreateSession Die SnmpCreateSession-Funktion fordert die Microsoft WinSNMP-Implementierung an, eine Sitzung für die WinSNMP-Anwendung zu öffnen.
SnmpCreateVbl Die WinSNMP SnmpCreateVbl-Funktion erstellt eine neue Variablenbindungsliste für die aufrufende WinSNMP-Anwendung.
SnmpDecodeMsg Die WinSNMP SnmpDecodeMsg-Funktion decodiert eine codierte SNMP-Nachricht in ihre Komponenten. Diese Funktion führt die entgegengesetzte Aktion der WinSNMP SnmpEncodeMsg-Funktion aus.
SnmpDeleteVb Die WinSNMP SnmpDeleteVb-Funktion entfernt einen Variablenbindungseintrag aus einer Variablenbindungsliste.
SnmpDuplicatePdu Die WinSNMP SnmpDuplicatePdu-Funktion dupliziert die SNMP-Protokolldateneinheit (PDU), die vom PDU-Parameter identifiziert wird, und weist den erforderlichen Arbeitsspeicher für die doppelte PDU zu.
SnmpDuplicateVbl Die WinSNMP SnmpDuplicateVbl-Funktion kopiert eine Variablenbindungsliste für die angegebene WinSNMP-Sitzung. Diese Funktion gibt ein Handle an die Liste der kopierten Variablenbindungen zurück und weist den erforderlichen Arbeitsspeicher zu.
SnmpEncodeMsg Die Microsoft WinSNMP-Implementierung verwendet die Parameter, die in der WinSNMP SnmpEncodeMsg-Funktion übergeben werden, um eine SNMP-Nachricht zu codieren.
SnmpEntityToStr Die WinSNMP SnmpEntityToStr-Funktion gibt eine Zeichenfolge zurück, die eine SNMP-Verwaltungsentität identifiziert.
SnmpFreeContext Die WinSNMP SnmpFreeContext-Funktion gibt Ressourcen frei, die einem SNMP-Kontext zugeordnet sind, bei dem es sich um eine Gruppe verwalteter Objektressourcen handelt.
SnmpFreeDescriptor Eine WinSNMP-Anwendung verwendet die SnmpFreeDescriptor-Funktion, um die Microsoft WinSNMP-Implementierung darüber zu informieren, dass sie keinen Zugriff mehr auf ein Deskriptorobjekt benötigt.
SnmpFreeEntity Die WinSNMP SnmpFreeEntity-Funktion gibt Ressourcen frei, die einer SNMP-Verwaltungsentität zugeordnet sind.
SnmpFreePdu Die WinSNMP SnmpFreePdu-Funktion gibt Ressourcen frei, die einer SNMP-Protokolldateneinheit (PDU) zugeordnet sind, die von snmpCreatePdu oder der SnmpDuplicatePdu-Funktion erstellt wurde.
SnmpFreeVbl Die WinSNMP SnmpFreeVbl-Funktion gibt Ressourcen frei, die einer Variablenbindungsliste zugeordnet sind. Hierbei handelt es sich um Ressourcen, die zuvor durch einen Aufruf der SnmpCreateVbl-Funktion oder der SnmpDuplicateVbl-Funktion in einer WinSNMP-Anwendung zugewiesen wurden.
SnmpGetLastError Die WinSNMP SnmpGetLastError-Funktion gibt den Codewert des letzten Fehlers der aufrufenden Anwendung zurück. Der Wert gibt den Grund an, warum beim letzten Funktionsaufruf, der von der WinSNMP-Anwendung ausgeführt wurde, ein Fehler aufgetreten ist.
SnmpGetPduData Die WinSNMP SnmpGetPduData-Funktion gibt ausgewählte Datenfelder aus einer angegebenen SNMP-Protokolldateneinheit (PDU) zurück.
SnmpGetRetransmitMode Die WinSNMP SnmpGetRetransmitMode-Funktion gibt die aktuelle Einstellung des Erneutübertragungsmodus an eine WinSNMP-Anwendung zurück.
SnmpGetRetry Die WinSNMP SnmpGetRetry-Funktion gibt den Wert der Wiederholungsanzahl in Einheiten für die erneute Übertragung von SNMP-Nachrichtenanforderungen zurück. Die Wiederholungsanzahl gilt für Aufrufe, die eine WinSNMP-Anwendung an die SnmpSendMsg-Funktion für eine angegebene Verwaltungsentität sendet.
SnmpGetTimeout Die WinSNMP SnmpGetTimeout-Funktion gibt den Timeoutwert in hundertstel Sekunden für die Übertragung von SNMP-Nachrichtenanforderungen zurück.
SnmpGetTranslateMode Die WinSNMP SnmpGetTranslateMode-Funktion gibt die aktuelle Einstellung des Entitäts- und Kontextübersetzungsmodus an eine WinSNMP-Anwendung zurück.
SnmpGetVb Eine WinSNMP-Anwendung ruft die SnmpGetVb-Funktion auf, um Informationen aus einer Variablenbindungsliste abzurufen. Diese WinSNMP-Funktion ruft einen Variablennamen und den zugehörigen Wert aus dem Variablenbindungseintrag ab, der durch den Indexparameter angegeben wird.
SnmpGetVendorInfo Eine WinSNMP-Anwendung ruft die SnmpGetVendorInfo-Funktion auf, um Informationen zur Microsoft WinSNMP-Implementierung abzurufen.
SnmpListen Die WinSNMP SnmpListen-Funktion registriert eine WinSNMP-Anwendung als SNMP-Agent.
SnmpOidCompare Die WinSNMP SnmpOidCompare-Funktion vergleicht lexikografisch zwei SNMP-Objektbezeichner bis zu der länge, die durch den maxlen-Parameter angegeben wird.
SnmpOidCopy Die WinSNMP SnmpOidCopy-Funktion kopiert einen SNMP-Objektbezeichner und weist den erforderlichen Arbeitsspeicher für die Kopie zu.
SnmpOidToStr Die WinSNMP SnmpOidToStr-Funktion konvertiert die interne binäre Darstellung eines SNMP-Objektbezeichners in sein gepunktetes numerisches Zeichenfolgenformat, z. B. in "1.2.3.4.5.6".
SnmpOpen Die SnmpOpen-Funktion fordert die Microsoft WinSNMP-Implementierung an, um eine Sitzung für die WinSNMP-Anwendung zu öffnen.
SnmpRecvMsg Die WinSNMP SnmpRecvMsg-Funktion ruft die Ergebnisse einer abgeschlossenen asynchronen Anforderung ab, die von einem Aufruf der SnmpSendMsg-Funktion in Form einer SNMP-Nachricht übermittelt wird.
SnmpRegister Die WinSNMP SnmpRegister-Funktion registriert oder hebt die Registrierung einer WinSNMP-Anwendung für den Trap- und Benachrichtigungsempfang auf. Die Anwendung kann Traps und Benachrichtigungen registrieren und empfangen oder die Registrierung von Traps und Benachrichtigungen aufheben und deaktivieren.
SnmpSendMsg Eine WinSNMP-Anwendung ruft die SnmpSendMsg-Funktion auf, um anzufordern, dass die Microsoft WinSNMP-Implementierung eine SNMP-Protokolldateneinheit (PDU) in Form einer SNMP-Nachricht sendet.
SnmpSetPduData Die WinSNMP SnmpSetPduData-Funktion aktualisiert ausgewählte Datenfelder in der angegebenen SNMP-Protokolldateneinheit (PDU).
SnmpSetPort Eine WinSNMP-Anwendung ruft die SnmpSetPort-Funktion auf, um den Port zu ändern, der einer Zielentität zugewiesen ist. Die SnmpSetPort-Funktion ist ein Element der WinSNMP-API, Version 2.0.
SnmpSetRetransmitMode Die WinSNMP SnmpSetRetransmitMode-Funktion ermöglicht es einer WinSNMP-Anwendung, den Erneutübertragungsmodus festzulegen.
SnmpSetRetry Die WinSNMP SnmpSetRetry-Funktion ermöglicht es einer WinSNMP-Anwendung, den Wert der Wiederholungsanzahl für die erneute Übertragung von SNMP-Nachrichtenanforderungen zu ändern.
SnmpSetTimeout Die WinSNMP SnmpSetTimeout-Funktion ermöglicht es einer WinSNMP-Anwendung, den Timeoutwert für die Übertragung von SNMP-Nachrichtenanforderungen zu ändern.
SnmpSetTranslateMode Die WinSNMP SnmpSetTranslateMode-Funktion ermöglicht es einer WinSNMP-Anwendung, den Entitäts- und Kontextübersetzungsmodus zu ändern. Der Entitäts- und Kontextübersetzungsmodus wirkt sich auf die Interpretation und Rückgabe von WinSNMP-Eingabe- und Ausgabezeichenfolgenparametern aus.
SnmpSetVb Die WinSNMP SnmpSetVb-Funktion ändert Variablenbindungseinträge in einer Variablenbindungsliste. Diese Funktion fügt auch neue Variablenbindungseinträge an eine vorhandene Variablenbindungsliste an.
SnmpStartup Die SnmpStartup-Funktion benachrichtigt die Microsoft WinSNMP-Implementierung, dass die WinSNMP-Anwendung die Dienste der Implementierung erfordert.
SnmpStartupEx Die SnmpStartupEx-Funktion benachrichtigt die Microsoft WinSNMP-Implementierung, dass die WinSNMP-Anwendung die Dienste der Implementierung benötigt.
SnmpStrToContext Die WinSNMP SnmpStrToContext-Funktion gibt ein Handle für SNMP-Kontextinformationen zurück, das für die Microsoft WinSNMP-Implementierung spezifisch ist.
SnmpStrToEntity Die WinSNMP SnmpStrToEntity-Funktion gibt einen Handle zu Informationen zu einer SNMP-Verwaltungsentität zurück, die für die Microsoft WinSNMP-Implementierung spezifisch ist.
SnmpStrToOid Die WinSNMP SnmpStrToOid-Funktion konvertiert das gepunktete numerische Zeichenfolgenformat eines SNMP-Objektbezeichners, z. B. "1.2.3.4.5.6", in die interne binäre Darstellung.

Rückruffunktionen

SNMPAPI_CALLBACK Die Microsoft WinSNMP-Implementierung ruft die SNMPAPI_CALLBACK-Funktion auf, um eine WinSNMP-Sitzung zu benachrichtigen, dass eine SNMP-Nachricht oder ein asynchrones Ereignis verfügbar ist.

Strukturen

smiCNTR64 Die WinSNMP smiCNTR64-Struktur enthält einen 64-Bit-Ganzzahlwert ohne Vorzeichen. Die Struktur stellt einen 64-Bit-Zähler dar.
smiOCTETS Die WinSNMP-smiOCTETS-Struktur übergibt Kontextzeichenfolgen an mehrere WinSNMP-Funktionen. Die Struktur beschreibt und empfängt auch codierte SNMP-Nachrichten.
smiOID Die WinSNMP-smiOID-Struktur übergibt Objektbezeichner an mehrere WinSNMP-Funktionen. Die Struktur empfängt auch den Variablennamen eines Variablenbindungseintrags in einem Aufruf der SnmpGetVb-Funktion.
smiVALUE Die WinSNMP smiVALUE-Struktur beschreibt den Wert, der einem Variablennamen in einem Variablenbindungseintrag zugeordnet ist.
smiVENDORINFO Die smiVENDORINFO-Struktur enthält Informationen zur Microsoft WinSNMP-Implementierung.