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 |