Función SnmpClose (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 administración remota de Windows, que es la implementación de Microsoft de WS-Man.]
La función SnmpClose permite que la implementación de Microsoft WinSNMP desasigne la memoria, los recursos y las estructuras de datos asociadas a una sesión de WinSNMP. La función SnmpClose de WinSNMP también cierra los mecanismos de comunicaciones que la implementación se abre como resultado de una llamada a la función SnmpCreateSession .
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpClose(
[in] HSNMP_SESSION session
);
Parámetros
[in] session
Controla la sesión de WinSNMP para cerrarla.
Valor devuelto
Si la función se realiza correctamente, se SNMPAPI_SUCCESS el valor devuelto.
Si se produce un error en la función, el valor devuelto se 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 session no es válido. |
|
Se produjo un error desconocido o no definido. |
Comentarios
Se recomienda que una aplicación WinSNMP llame a la función SnmpClose una vez para cada sesión que la aplicación abrió mediante la función SnmpCreateSession . Si una aplicación WinSNMP finaliza inesperadamente, debe llamar a SnmpCleanup antes de finalizar para permitir que la implementación desasigne todos los recursos. La implementación procesa una llamada SnmpCleanup como si fuera una serie de llamadas SnmpClose , una llamada para cada sesión abierta como resultado de una llamada a SnmpCreateSession.
Cuando la implementación cierra una sesión, descarta todas las solicitudes asincrónicas entrantes y salientes pendientes y respuestas de la sesión. Para obtener más información, consulte Sesiones 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 |