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 |
|---|---|
|
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen. |
|
Während der Speicherbelegung ist ein Fehler aufgetreten. |
|
Der Indexparameter ist ungültig. |
|
Der vbl-Parameter ist ungültig. |
|
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:
- Der Rückgabewert eines Aufrufs der SnmpCountVbl-Funktion
- Das Fehlerindexfeld einer SNMP_PDU_RESPONSE PDU, die von einem Aufruf der SnmpRecvMsg-Funktion zurückgegeben wird
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 |