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

Confira também

SnmpClose

SnmpCreateSession

Funções WinSNMP

Visão geral da API do WinSNMP