SNMPAPI_CALLBACK função de retorno de chamada (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 implementação do Microsoft WinSNMP chama a função SNMPAPI_CALLBACK para notificar uma sessão WinSNMP de que uma mensagem SNMP ou evento assíncrono está disponível.
SNMPAPI_CALLBACK é um espaço reservado para um nome de função de retorno de chamada definido pelo aplicativo ou biblioteca.
Sintaxe
SNMPAPI_CALLBACK SnmpapiCallback;
SNMPAPI_STATUS SnmpapiCallback(
[in] HSNMP_SESSION hSession,
[in] HWND hWnd,
[in] UINT wMsg,
[in] WPARAM wParam,
[in] LPARAM lParam,
[in] LPVOID lpClientData
)
{...}
Parâmetros
[in] hSession
Manipule para a sessão WinSNMP.
[in] hWnd
Manipule para uma janela do aplicativo WinSNMP para notificar quando uma solicitação assíncrona for concluída ou quando ocorrer uma notificação de interceptação. Esse parâmetro não tem significado para a sessão WinSNMP, mas a implementação sempre passa o valor para a função de retorno de chamada.
[in] wMsg
Especifica um inteiro sem sinal que identifica a mensagem de notificação a ser enviada para a janela do aplicativo WinSNMP. Esse parâmetro não tem significado para a sessão WinSNMP, mas a implementação sempre passa o valor para a função de retorno de chamada.
[in] wParam
Especifica um valor de 32 bits definido pelo aplicativo que identifica o tipo de notificação. Se esse parâmetro for igual a zero, uma mensagem SNMP estará disponível para a sessão. O aplicativo deve chamar a função SnmpRecvMsg para recuperar a mensagem. Se esse parâmetro não for igual a zero, ele indicará uma notificação de evento assíncrona para a sessão. Para obter informações adicionais, consulte a seção Comentários a seguir.
[in] lParam
Especifica um valor de 32 bits definido pelo aplicativo que especifica o identificador de solicitação da PDU que está sendo processada.
[in] lpClientData
Se o parâmetro lpClientData não fosse NULL na chamada para a função SnmpCreateSession para esta sessão, esse parâmetro será um ponteiro para dados definidos pelo aplicativo.
Retornar valor
A função deve retornar SNMPAPI_SUCCESS para continuar a execução do aplicativo. Se a função retornar qualquer outro valor, a implementação responderá como se o aplicativo chamasse a função SnmpClose para a sessão indicada.
Comentários
Quando a implementação está executando a política de retransmissão para o aplicativo WinSNMP e ocorre um tempo limite de transmissão, a implementação informa a sessão do erro. Nessa situação, o valor do parâmetro wParam seria SNMPAPI_TL_TIMEOUT. Para obter uma lista de outros erros de camada de transporte, consulte as páginas de referência para as funções SnmpRegister, SnmpSendMsg e SnmpRecvMsg .
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 |