SnmpDuplicateVbl-Funktion (winsnmp.h)

[SNMP ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen die Windows-Remoteverwaltung, die Microsoft-Implementierung von WS-Man.]

Die WinSNMP SnmpDuplicateVbl-Funktion kopiert eine Variablenbindungsliste für die angegebene WinSNMP-Sitzung. Diese Funktion gibt ein Handle an die Liste der kopierten Variablenbindungen zurück und weist den erforderlichen Arbeitsspeicher zu.

Syntax

HSNMP_VBL SNMPAPI_CALL SnmpDuplicateVbl(
  [in] HSNMP_SESSION session,
  [in] HSNMP_VBL     vbl
);

Parameter

[in] session

Handle mit der WinSNMP-Sitzung.

[in] vbl

Behandeln Sie die zu kopierende Variablenbindungsliste. Die Liste der Quellvariablenbindungen kann leer sein.

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 Speicherzuordnung ist ein Fehler aufgetreten.
SNMPAPI_SESSION_INVALID	Das Sitzungshandle ist ungültig.
SNMPAPI_VBL_INVALID	Der vbl-Parameter ist ungültig.
SNMPAPI_OTHER_ERROR	Ein unbekannter oder nicht definierter Fehler ist aufgetreten.

Hinweise

Die SnmpDuplicateVbl-Funktion erstellt eine neue Variablenbindungsliste für die angegebene WinSNMP-Sitzung. Diese Funktion initialisiert die neue Liste mit einer Kopie der Daten in der Quellvariablenbindungsliste.

Das Handle, das die SnmpDuplicateVbl-Funktion zurückgibt, ist eindeutig unter den Listenhandles für Variablenbindungen, die in der WinSNMP-Anwendung aktiv sind.

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

Anforderung	Wert
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

SnmpCreateVbl

SnmpFreeVbl

WinSNMP-Funktionen

Übersicht über die WinSNMP-API