Función SnmpFreeContext (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 SnmpFreeContext de WinSNMP libera los recursos asociados a un contexto SNMP, que es un conjunto de recursos de objeto administrado.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpFreeContext(
[in] HSNMP_CONTEXT context
);
Parámetros
[in] context
Controle el contexto 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 contexto 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 con la función WinSNMP que corresponde al recurso. Por ejemplo, las aplicaciones deben llamar a la función SnmpFreeContext para liberar los recursos asignados por una llamada a la función SnmpStrToContext . Esto reduce la carga de trabajo de la implementación y debe mejorar el servicio de la implementación en todas las aplicaciones.
Para obtener más información, consulte Conceptos de Administración de datos de WinSNMP.
Requisitos
| 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 |