SnmpSetVb-Funktion (winsnmp.h)

Artikel
08/27/2023

[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
SNMPAPI_NOT_INITIALIZED	Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen.
SNMPAPI_ALLOC_ERROR	Während der Speicherbelegung ist ein Fehler aufgetreten.
SNMPAPI_VBL_INVALID	Der vbl-Parameter ist ungültig.
SNMPAPI_INDEX_INVALID	Der Indexparameter ist ungültig.
SNMPAPI_OID_INVALID	Der Name-Parameter ist ungültig.
SNMPAPI_SYNTAX_INVALID	Der Syntaxmember der Struktur, auf die der value-Parameter verweist, ist ungültig.
SNMPAPI_OTHER_ERROR	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