SnmpCreateVbl-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 SnmpCreateVbl-Funktion erstellt eine neue Variablenbindungsliste für die aufrufende WinSNMP-Anwendung. Wenn die Parameter name und value nicht NULL sind, verwendet SnmpCreateVbl ihre Werte, um den ersten Variablenbindungseintrag für die neue Variablenbindungsliste zu erstellen. Die SnmpCreateVbl-Funktion gibt ein Handle an die neue Variablenbindungsliste zurück und weist den erforderlichen Arbeitsspeicher dafür zu.

Syntax

HSNMP_VBL SNMPAPI_CALL SnmpCreateVbl(
  [in] HSNMP_SESSION session,
  [in] smiLPCOID     name,
  [in] smiLPCVALUE   value
);

Parameter

[in] session

Handle für die WinSNMP-Sitzung.

[in] name

Zeiger auf eine smiOID-Struktur , die den Variablennamen für den ersten Variablenbindungseintrag enthält. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] value

Zeiger auf eine smiVALUE-Struktur , die einen Wert enthält, der der Variablen im ersten Variablenbindungseintrag zugeordnet werden soll. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für eine neue Variablenbindungsliste.

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_SESSION_INVALID	Das Sitzungshandle ist ungültig.
SNMPAPI_OID_INVALID	Der name-Parameter verweist auf eine ungültige smiOID-Struktur .
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

Die SnmpCreateVbl-Funktion verwendet die Werte der Parameter name und value , um den ersten Variablenbindungseintrag einer neuen Variablenbindungsliste zu erstellen und zu initialisieren. Wenn der name-ParameterNULL ist, ignoriert die Microsoft WinSNMP-Implementierung den Value-Parameter und erstellt eine leere Variablenbindungsliste.

Wenn der name-Parameter nicht NULL, aber der value-ParameterNULL ist, erstellt und initialisiert die Implementierung den ersten Variablenbindungseintrag in der Variablenbindungsliste. Es initialisiert den Syntaxmember der Struktur, auf die der value-Parameter mit dem Wert SNMP_SYNTAX_NULL.

Die WinSNMP-Anwendung muss die Ressourcen freigeben, die jeder Variablenbindungsliste zugeordnet sind. Dazu sollte jeder Aufruf der Funktionen SnmpCreateVbl und SnmpDuplicateVbl mit einem entsprechenden Aufruf der SnmpFreeVbl-Funktion übereinstimmen. Um Speicherverluste zu vermeiden, muss eine WinSNMP-Anwendung SnmpFreeVbl aufrufen, bevor sie das Handle in einer Variablenbindungsliste in einem nachfolgenden Aufruf von SnmpCreateVbl oder SnmpDuplicateVbl wiederverwendet. Weitere Informationen finden Sie unter WinSNMP Datenverwaltung Concepts.

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