Função SnmpMgrTrapListen (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 SnmpMgrTrapListen registra a capacidade de um aplicativo gerenciador SNMP receber armadilhas SNMP do Serviço de Interceptação SNMP. Essa função é um elemento da API de Gerenciamento SNMP.

Sintaxe

BOOL SNMP_FUNC_TYPE SnmpMgrTrapListen(
  [out] HANDLE *phTrapAvailable
);

Parâmetros

[out] phTrapAvailable

Ponteiro para um identificador de evento para receber uma indicação de que há armadilhas disponíveis e que o aplicativo deve chamar a função SnmpMgrGetTrap .

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. Para obter informações de erro estendidas, chame GetLastError, que pode retornar qualquer um dos seguintes códigos de erro.

Código de retorno	Descrição
SNMP_MEM_ALLOC_ERROR	Indica um erro de alocação de memória.
SNMP_MGMTAPI_TRAP_DUPINIT	Indica que essa função já foi chamada.
SNMP_MGMTAPI_TRAP_ERRORS	Indica que ocorreu um ou mais erros; armadilhas não são acessíveis. O aplicativo pode tentar chamar a função novamente.

 

Essa função também pode retornar outros erros do sistema.

Comentários

É importante observar que, para usuários que não são administradores, a função SnmpMgrTrapListen só terá êxito se o serviço de interceptação SNMP tiver sido iniciado.

O aplicativo deve sempre chamar a função SnmpMgrTrapListen antes de chamar a função SnmpMgrGetTrap . Isso ocorre porque o identificador de evento apontado pelo parâmetro phTrapAvailable permite a aquisição controlada por eventos de armadilhas SNMP. A API de Gerenciamento SNMP sinaliza o evento de um aplicativo quando o Serviço de Interceptação SNMP fornece uma armadilha.

O aplicativo também pode sondar a função SnmpMgrGetTrap para interceptações em intervalos regulares. Nesse caso, o aplicativo deve chamar repetidamente SnmpMgrGetTrap até que a função retorne zero.

Windows Server 2003: Os aplicativos do gerenciador SNMP podem chamar SnmpMgrClose com um parâmetro de sessãoNULL para limpo 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 .

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

SnmpMgrGetTrap