Funzione SnmpDuplicateVbl (winsnmp.h)
[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.
La funzione SnmpDuplicateVbl WinSNMP copia un elenco di associazioni di variabili per la sessione WinSNMP specificata. Questa funzione restituisce un handle all'elenco di associazioni di variabili copiate e alloca qualsiasi memoria necessaria.
Sintassi
HSNMP_VBL SNMPAPI_CALL SnmpDuplicateVbl(
[in] HSNMP_SESSION session,
[in] HSNMP_VBL vbl
);
Parametri
[in] session
Gestire la sessione WinSNMP.
[in] vbl
Gestire l'elenco di associazioni di variabili da copiare. L'elenco associazioni di variabili di origine può essere vuoto.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un handle per un nuovo elenco di associazioni di variabili.
Se la funzione ha esito negativo, il valore restituito è SNMPAPI_FAILURE. Per ottenere informazioni sull'errore estese, chiamare SnmpGetLastError. La funzione SnmpGetLastError può restituire uno degli errori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
L'handle di sessione non è valido. |
|
Il parametro vbl non è valido. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
La funzione SnmpDuplicateVbl crea un nuovo elenco di associazioni di variabili per la sessione WinSNMP specificata. Questa funzione inizializza il nuovo elenco con una copia dei dati nell'elenco associazioni di variabili di origine.
L'handle restituito dalla funzione SnmpDuplicateVbl è univoco tra gli handle dell'elenco di associazioni di variabili attivi all'interno dell'applicazione WinSNMP.
L'applicazione WinSNMP deve rilasciare le risorse associate a ogni elenco di associazioni di variabili. Questa operazione deve corrispondere a ogni chiamata alle funzioni SnmpCreateVbl e SnmpDuplicateVbl con una chiamata corrispondente alla funzione SnmpFreeVbl . Per evitare perdite di memoria, un'applicazione WinSNMP deve chiamare SnmpFreeVbl prima di riutilizzare l'handle in un elenco di associazioni di variabili in una chiamata successiva a SnmpCreateVbl o SnmpDuplicateVbl. Per altre informazioni, vedere Concetti di Gestione dati WinSNMP.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winsnmp.h |
| Libreria | Wsnmp32.lib |
| DLL | Wsnmp32.dll |