SnmpSetVb-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 SnmpSetVb-Funktion ändert Variablenbindungseinträge in einer Variablenbindungsliste. Diese Funktion fügt auch neue Variablenbindungseinträge an eine vorhandene Variablenbindungsliste an.
Syntax
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index,
[in] smiLPCOID name,
[in] smiLPCVALUE value
);
Parameter
[in] vbl
Handle für die zu aktualisierende Variablenbindungsliste.
[in] index
Gibt eine variable Lange Ganzzahl ohne Vorzeichen an, die die Position des Variablenbindungseintrags innerhalb der Variablenbindungsliste enthält, wenn dies ein Aktualisierungsvorgang ist. Wenn es sich um einen Anfügevorgang handelt, muss dieser Parameter gleich 0 sein. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
[in] name
Zeiger auf eine smiOID-Struktur , die den Namen der variablen darstellt, die angefügt oder geändert werden soll. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
[in] value
Zeiger auf eine smiVALUE-Struktur . Die -Struktur enthält den Wert, der der Variablen zugeordnet ist, die durch den name-Parameter angegeben wird.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Position des aktualisierten oder angefügten Variablenbindungseintrags in der Variablenbindungsliste. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
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 vbl-Parameter ist ungültig. |
|
Der Indexparameter ist ungültig. |
|
Der Name-Parameter ist ungültig. |
|
Der Syntaxmember der Struktur, auf die der value-Parameter verweist, ist ungültig. |
|
Es ist ein unbekannter oder nicht definierter Fehler aufgetreten. |
Hinweise
Gültige Werte für den Indexparameterbereich von null bis n. Der Wert 0 gibt einen Anfügevorgang an. Der Wert n ist die Gesamtzahl der Variablenbindungseinträge in der Variablenbindungsliste. Eine WinSNMP-Anwendung sollte die SnmpCountVbl-Funktion aufrufen, bevor snmpSetVb aufgerufen wird, um die Gesamtzahl der Variablenbindungseinträge abzurufen.
Wenn die Funktion erfolgreich einen Aktualisierungsvorgang ausführt, entspricht der Rückgabewert dem Wert des Indexparameters . Wenn die Funktion einen Variablenbindungseintrag anfüge, ist der Rückgabewert n + 1.
Wenn der name-Parameter nicht NULL, aber der value-ParameterNULL ist, initialisiert die Microsoft WinSNMP-Implementierung den neuen Variablenbindungseintrag, wobei der Wertmember auf NULL und der Syntaxmember auf SNMP_SYNTAX_ festgelegt ist.
Wenn der Indexparameter nicht gleich 0 ist und der Name-ParameterNULL ist, aktualisiert die Microsoft WinSNMP-Implementierung nur den Wert der Variablen, auf die der Indexparameter verweist.
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 |