Función SnmpMgrClose (mgmtapi.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 SnmpMgrClose cierra los sockets de comunicaciones y las estructuras de datos asociadas a la sesión especificada. Esta función es un elemento de la API de administración de SNMP.

Sintaxis

BOOL SNMP_FUNC_TYPE SnmpMgrClose(
  [in] LPSNMP_MGR_SESSION session
);

Parámetros

[in] session

Puntero a una estructura interna que especifica la sesión que se va a cerrar. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Esta función puede devolver códigos de error de Windows Sockets.

Comentarios

Windows Server 2003: Las aplicaciones de administrador snmp pueden llamar a SnmpMgrClose con un parámetro de sesiónNULL para limpiar los recursos asociados a una llamada correcta a la función SnmpMgrTrapListen. Sin embargo, tenga en cuenta que si la aplicación es un archivo DLL, no debe llamar a SnmpMgrClose desde su función de punto de entrada DllMain .

No se debe llamar a SnmpMgrClose cuando el archivo DLL de la aplicación está en proceso de descarga.

Windows Server 2003: SnmpMgrClose tarda más tiempo en ejecutarse en Windows Server 2003 en comparación con una llamada idéntica en Windows 2000. En concreto, una llamada a esta API tarda hasta un segundo en ejecutarse en Windows Server 2003, mientras que la misma llamada tarda aproximadamente 3 milisegundos en Windows 2000. esto puede causar problemas de rendimiento para las aplicaciones SNMP de Windows Server 2003 que llaman a SnmpMgrOpen y SnmpMgrClose con frecuencia.

Para solucionar este problema, cree una sesión adicional del administrador snmp mediante una llamada a SnmpMgrOpen en el host local durante el inicio de la aplicación y manténgala abierta durante la duración de la aplicación. Al cerrar el administrador de sesiones, se cerrarán todas las sesiones asociadas, lo que solo requiere una llamada a SnmpMgrClose.

Windows Server 2003 con SP1: El problema anterior no se aplica a Windows 2003 Service Pack 1.

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	mgmtapi.h
Library	Mgmtapi.lib
Archivo DLL	Mgmtapi.dll

Consulte también

Funciones SNMP

Introducción al Protocolo simple de administración de redes (SNMP)

SnmpMgrOpen

SnmpMgrRequest