Freigeben über


SnmpDeleteVb-Funktion (winsnmp.h)

[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 die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]

Die WinSNMP-Funktion SnmpDeleteVb entfernt einen Variablenbindungseintrag aus einer Variablenbindungsliste.

Syntax

SNMPAPI_STATUS SNMPAPI_CALL SnmpDeleteVb(
  [in] HSNMP_VBL vbl,
  [in] smiUINT32 index
);

Parameter

[in] vbl

Handle für die zu aktualisierende Variablenbindungsliste.

[in] index

Gibt eine variable Lange Ganzzahl ohne Vorzeichen an, die den zu entfernenden Variablenbindungseintrag identifiziert. Diese Variable enthält die Position des Variablenbindungseintrags innerhalb der Variablenbindungsliste.

Gültige Werte für diesen Parameter liegen im Bereich von 1 bis n, wobei 1 den ersten Variablenbindungseintrag in der Variablenbindungsliste und n die Gesamtzahl der Einträge in der Variablenbindungsliste angibt. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert SNMPAPI_SUCCESS.

Wenn die Funktion fehlschlägt, wird der Rückgabewert SNMPAPI_FAILURE. Rufen Sie SnmpGetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Die SnmpGetLastError-Funktion kann einen der folgenden Fehler zurückgeben.

Rückgabecode Beschreibung
SNMPAPI_NOT_INITIALIZED
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen.
SNMPAPI_ALLOC_ERROR
Während der Speicherbelegung ist ein Fehler aufgetreten.
SNMPAPI_INDEX_INVALID
Der Indexparameter ist ungültig.
SNMPAPI_VBL_INVALID
Der vbl-Parameter ist ungültig.
SNMPAPI_OTHER_ERROR
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten.

Hinweise

Eine WinSNMP-Anwendung kann die SnmpDeleteVb-Funktion verwenden, um ungültige Variablenbindungseinträge zu löschen. Wenn eine SNMP_PDU_RESPONSE Protokolldateneinheit (Protocol Data Unit, PDU) einen Fehler enthält, der auf einen ungültigen Variablenbindungseintrag hinweist, kann die Anwendung SnmpDeleteVb aufrufen, um den Eintrag zu löschen. Anschließend kann die Anwendung die Anforderungs-PDU mit einem Aufruf der SnmpSendMsg-Funktion erneut übermitteln, ohne dass der ungültige Variablenbindungseintrag in der Variablenbindungsliste enthalten ist. Anforderungs-PDUs enthalten die PDU-Datentypen SNMP_PDU_GET, SNMP_PDU_GETNEXT und SNMP_PDU_GETBULK.

Nachdem die SnmpDeleteVb-Funktion einen Variablenbindungseintrag gelöscht hat, wird der Indexwert aller Einträge nach dem gelöschten Eintrag um eins verringert. Ein Aufruf der SnmpCountVbl-Funktion gibt die neue Gesamtanzahl von Einträgen in der Variablenbindungsliste zurück. Die neue Summe ist um eins kleiner als die Anzahl, die von einem Aufruf von SnmpCountVbl vor dem aktuellen Aufruf von SnmpDeleteVb zurückgegeben wurde.

Wenn eine WinSNMP-Anwendung die SnmpDeleteVb-Funktion aufruft und den letzten Variablenbindungseintrag in einer Variablenbindungsliste löscht, ist das Ergebnis eine leere Variablenbindungsliste. Die Liste der Variablenbindungen verfügt weiterhin über ein gültiges Handle, und die WinSNMP-Anwendung muss das Handle mit einem Aufruf der SnmpFreeVbl-Funktion freigeben.

Im Folgenden sind gültige Werte aufgeführt, die für den index-Parameter verwendet werden können:

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winsnmp.h
Bibliothek Wsnmp32.lib
DLL Wsnmp32.dll

Weitere Informationen

SnmpCountVbl

SnmpFreeVbl

SnmpRecvMsg

WinSNMP-Funktionen

Übersicht über winSNMP-API