Funzione SnmpFreeVbl (winsnmp.h)

Articolo
08/27/2023

[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 SnmpFreeVbl WinSNMP rilascia risorse associate a un elenco di associazioni di variabili. Queste sono le risorse allocate in precedenza da una chiamata alla funzione SnmpCreateVbl o alla funzione SnmpDuplicateVbl in un'applicazione WinSNMP.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeVbl(
  [in] HSNMP_VBL vbl
);

Parametri

[in] vbl

Gestire l'elenco di associazioni di variabili da rilasciare.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è SNMPAPI_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è SNMPAPI_FAILURE. Per ottenere informazioni sull'errore estese, chiamare SnmpGetLastError specificando un valore NULL nel relativo parametro di sessione . La funzione SnmpGetLastError può restituire uno degli errori seguenti.

Codice restituito	Descrizione
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_VBL_INVALID	Il parametro vbl non è valido.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

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.

Se l'applicazione chiama snmpClose o la funzione SnmpCleanup , l'implementazione di Microsoft WinSNMP libera tutte le risorse allocate per la sessione WinSNMP. Tuttavia, anche se l'applicazione non riutilizza un handle elenco di associazioni di variabili, è consigliabile che l'applicazione libera le risorse delle singole variabili con la funzione SnmpFreeVbl . Ciò riduce il carico di lavoro dell'implementazione e dovrebbe migliorare il servizio a tutte le applicazioni. Per altre informazioni, vedere Concetti di Gestione dati WinSNMP.

Requisiti


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