Função SnmpClose (winsnmp.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 SnmpClose permite que a implementação do Microsoft WinSNMP desaloque memória, recursos e estruturas de dados associadas a uma sessão WinSNMP. A função WinSNMP SnmpClose também fecha mecanismos de comunicação que a implementação abriu como resultado de uma chamada para a função SnmpCreateSession .

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpClose(
  [in] HSNMP_SESSION session
);

Parâmetros

[in] session

Manipule para a sessão WinSNMP a ser fechada.

Retornar valor

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

Se a função falhar, o valor retornado será SNMPAPI_FAILURE. Para obter informações de erro estendidas, chame SnmpGetLastError especificando um valor NULL em seu parâmetro de sessão . A função SnmpGetLastError pode retornar um dos erros a seguir.

Código de retorno	Descrição
SNMPAPI_NOT_INITIALIZED	A função SnmpStartup não foi concluída com êxito.
SNMPAPI_ALLOC_ERROR	Ocorreu um erro durante a alocação de memória.
SNMPAPI_SESSION_INVALID	O parâmetro de sessão é inválido.
SNMPAPI_OTHER_ERROR	Ocorreu um erro desconhecido ou indefinido.

Comentários

É recomendável que um aplicativo WinSNMP chame a função SnmpClose uma vez para cada sessão que o aplicativo abriu usando a função SnmpCreateSession . Se um aplicativo WinSNMP for encerrado inesperadamente, ele deverá chamar SnmpCleanup antes de ser encerrado para permitir que a implementação desaloque todos os recursos. A implementação processa uma chamada SnmpCleanup como se fosse uma série de chamadas SnmpClose , uma chamada para cada sessão aberta como resultado de uma chamada para SnmpCreateSession.

Quando a implementação fecha uma sessão, ela descarta todas as solicitações e respostas assíncronas de entrada e saída pendentes para a sessão. Para obter informações adicionais, consulte Sessões WinSNMP.

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	winsnmp.h
Biblioteca	Wsnmp32.lib
DLL	Wsnmp32.dll

Confira também

SnmpCleanup

SnmpCreateSession

Funções WinSNMP

Visão geral da API do WinSNMP