Função SnmpMgrClose (mgmtapi.h)

[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use o Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]

A função SnmpMgrClose fecha os soquetes de comunicação e as estruturas de dados associadas à sessão especificada. Essa função é um elemento da API de Gerenciamento SNMP.

Sintaxe

BOOL SNMP_FUNC_TYPE SnmpMgrClose(
  [in] LPSNMP_MGR_SESSION session
);

Parâmetros

[in] session

Ponteiro para uma estrutura interna que especifica a sessão a ser fechada. Para obter mais informações, consulte a seção Comentários a seguir.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero.

Essa função pode retornar códigos de erro do Windows Sockets.

Comentários

Windows Server 2003: Os aplicativos gerenciador SNMP podem chamar SnmpMgrClose com um parâmetro de sessãoNULL para limpo os recursos associados a uma chamada bem-sucedida para a função SnmpMgrTrapListen. No entanto, observe que, se o aplicativo for uma DLL, ele não deverá chamar SnmpMgrClose de sua função de ponto de entrada DllMain .

SnmpMgrClose não deve ser chamado quando a DLL do aplicativo está em processo de descarregamento.

Windows Server 2003: SnmpMgrClose leva mais tempo para ser executado no Windows Server 2003 quando comparado a uma chamada idêntica no Windows 2000. Especificamente, uma chamada para essa API leva até um segundo para ser executada no Windows Server 2003, enquanto a mesma chamada leva cerca de 0,3 milissegundos no Windows 2000. isso pode causar problemas de desempenho para aplicativos SNMP do Windows Server 2003 que chamam SnmpMgrOpen e SnmpMgrClose com frequência.

Para resolver esse problema, crie uma sessão extra do gerenciador SNMP chamando SnmpMgrOpen no host local durante a inicialização do aplicativo e mantenha-a aberta durante o tempo de vida do aplicativo. Fechar o gerenciador de sessão fechará todas as sessões associadas, exigindo apenas uma chamada para SnmpMgrClose.

Windows Server 2003 com SP1: O problema acima não se aplica ao Windows 2003 Service Pack 1.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	mgmtapi.h
Biblioteca	Mgmtapi.lib
DLL	Mgmtapi.dll

Confira também

Funções SNMP

Visão geral do Protocolo SNMP

SnmpMgrOpen

SnmpMgrRequest