Funzione SnmpFreeDescriptor (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.
Un'applicazione WinSNMP usa la funzione SnmpFreeDescriptor per informare l'implementazione di Microsoft WinSNMP che non richiede più l'accesso a un oggetto descrittore. Questa funzione WinSNMP segnala all'implementazione di liberare la memoria allocata per l'oggetto descrittore.
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeDescriptor(
[in] smiUINT32 syntax,
[in] smiLPOPAQUE descriptor
);
Parametri
[in] syntax
Specifica il tipo di dati della sintassi dell'oggetto descrittore di destinazione.
[in] descriptor
Puntatore a una struttura smiOPAQUE che contiene l'oggetto descrittore di destinazione da rilasciare.
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. |
|
Il parametro della sintassi non è valido. |
|
Il parametro del descrittore non è valido. Per altre informazioni, vedere la sezione Osservazioni seguente. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
L'implementazione alloca e dealloca la memoria per gli oggetti descrittore di output con lunghezze variabili. Questa allocazione di memoria e deallocazione sono limitate all'implementazione, ad eccezione dell'interfaccia fornita dalla funzione SnmpFreeDescriptor . Per altre informazioni, vedere Freeing WinSNMP Descriptors .For additional information, see Freeing WinSNMP Descriptors.
L'implementazione restituisce il codice di errore SNMPAPI_OPERATION_INVALID se il parametro descrittore specifica un'allocazione di memoria rilasciata dall'implementazione in una chiamata precedente a SnmpFreeDescriptor. La funzione restituisce lo stesso codice di errore se il parametro descrittore specifica un'allocazione di memoria che l'implementazione non ha eseguito per l'applicazione WinSNMP chiamante.
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 |