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 |
|---|---|
|
Die SnmpStartup-Funktion wurde nicht erfolgreich abgeschlossen. |
|
Während der Speicherzuordnung ist ein Fehler aufgetreten. |
|
Das Sitzungshandle ist ungültig. |
|
Der vbl-Parameter ist ungültig. |
|
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 |