Función SnmpFreeDescriptor (winsnmp.h)
[SNMP está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]
Una aplicación WinSNMP usa la función SnmpFreeDescriptor para informar a la implementación de Microsoft WinSNMP que ya no requiere acceso a un objeto descriptor. Esta función WinSNMP indica a la implementación que libere la memoria asignada para el objeto descriptor.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeDescriptor(
[in] smiUINT32 syntax,
[in] smiLPOPAQUE descriptor
);
Parámetros
[in] syntax
Especifica el tipo de datos de sintaxis del objeto descriptor de destino.
[in] descriptor
Puntero a una estructura smiOPAQUE que contiene el objeto descriptor de destino que se va a liberar.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es SNMPAPI_SUCCESS.
Si se produce un error en la función, el valor devuelto es SNMPAPI_FAILURE. Para obtener información de error extendida, llame a SnmpGetLastError especificando un valor NULL en su parámetro de sesión . La función SnmpGetLastError puede devolver uno de los siguientes errores.
| Código devuelto | Descripción |
|---|---|
|
La función SnmpStartup no se completó correctamente. |
|
Error durante la asignación de memoria. |
|
El parámetro de sintaxis no es válido. |
|
El parámetro descriptor no es válido. Para obtener más información, vea la siguiente sección Comentarios. |
|
Error desconocido o indefinido. |
Comentarios
La implementación asigna y desasigna la memoria para los objetos descriptores de salida con longitudes variables. Esta asignación y desasignación de memoria están restringidas a la implementación, excepto para la interfaz que proporciona la función SnmpFreeDescriptor . Para obtener más información, consulta Liberar descriptores winSNMP.
La implementación devuelve el código de error SNMPAPI_OPERATION_INVALID si el parámetro descriptor especifica una asignación de memoria que la implementación se publicó en una llamada anterior a SnmpFreeDescriptor. La función devuelve el mismo código de error si el parámetro descriptor especifica una asignación de memoria que la implementación no realizó para la aplicación WinSNMP que realiza la llamada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winsnmp.h |
| Library | Wsnmp32.lib |
| Archivo DLL | Wsnmp32.dll |