Funzione SnmpFreeDescriptor (winsnmp.h)

Articolo
03/04/2024

[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
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_SYNTAX_INVALID	Il parametro della sintassi non è valido.
SNMPAPI_OPERATION_INVALID	Il parametro del descrittore non è valido. Per altre informazioni, vedere la sezione Osservazioni seguente.
SNMPAPI_OTHER_ERROR	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

Vedi anche

Panoramica dell'API WinSNMP