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 |
|---|---|
|
Indica um erro de alocação de memória. |
|
Indica que essa função já foi chamada. |
|
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 |