Funzione SnmpFreePdu (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 SnmpFreePdu WinSNMP rilascia le risorse associate a un'unità dati del protocollo SNMP creata da SnmpCreatePdu o dalla funzione SnmpDuplicatePdu .
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreePdu(
[in] HSNMP_PDU PDU
);
Parametri
[in] PDU
Gestire il PDU SNMP per liberare.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene SNMPAPI_SUCCESS.
Se la funzione ha esito negativo, il valore restituito viene 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 |
|---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
L'handle PDU non è valido. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
Se l'applicazione chiama snmpClose o la funzione SnmpCleanup , l'implementazione di Microsoft WinSNMP libera tutte le risorse allocate per la sessione WinSNMP. È tuttavia consigliabile che l'applicazione liberi le singole risorse con la funzione WinSNMP corrispondente alla risorsa. Ciò riduce il carico di lavoro dell'implementazione e deve migliorare il servizio dell'implementazione a tutte le applicazioni. L'applicazione deve usare la funzione SnmpFreeVbl per deallocare le risorse dell'elenco di associazioni di variabili. Per altre informazioni, vedere Concetti di Gestione dati WinSNMP.
In WinSNMP esiste una voce di associazione di variabili solo all'interno di un elenco di associazioni di variabili, anche se l'elenco delle associazioni di variabili contiene una sola voce.
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 |