Función SnmpFreeEntity (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.]
La función SnmpFreeEntity de WinSNMP libera los recursos asociados a una entidad de administración snmp.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeEntity(
[in] HSNMP_ENTITY entity
);
Parámetros
[in] entity
Controle a la entidad de administración snmp que tendrá sus recursos liberados.
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 entidad no es válido. |
|
Error desconocido o indefinido. |
Comentarios
Cuando la aplicación WinSNMP llama a la función SnmpClose o a la función SnmpCleanup , la implementación de Microsoft WinSNMP libera todos los recursos asignados para la sesión de WinSNMP. Sin embargo, se recomienda que la aplicación WinSNMP libere recursos individuales mediante la función WinSNMP que corresponde al recurso. Por ejemplo, las aplicaciones deben llamar a la función SnmpFreeEntity para liberar los recursos asignados por una llamada a la función SnmpStrToEntity . Esto reduce la carga de trabajo de la implementación y debe mejorar el servicio de la implementación para todas las aplicaciones.
Para obtener más información, consulte Conceptos de Administración de datos de WinSNMP.
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 |