SNMPAPI_CALLBACK función de devolución de llamada (winsnmp.h)
[SNMP está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]
La implementación de Microsoft WinSNMP llama a la función SNMPAPI_CALLBACK para notificar a una sesión de WinSNMP que hay disponible un mensaje SNMP o un evento asincrónico.
SNMPAPI_CALLBACK es un marcador de posición para un nombre de función de devolución de llamada definido por la aplicación o biblioteca.
Sintaxis
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
Controle la sesión de WinSNMP.
[in] hWnd
Controle a una ventana de la aplicación WinSNMP para notificar cuándo se completa una solicitud asincrónica o cuando se produce una notificación de captura. Este parámetro no tiene importancia para la sesión winSNMP, pero la implementación siempre pasa el valor a la función de devolución de llamada.
[in] wMsg
Especifica un entero sin signo que identifica el mensaje de notificación que se va a enviar a la ventana de la aplicación WinSNMP. Este parámetro no tiene importancia para la sesión winSNMP, pero la implementación siempre pasa el valor a la función de devolución de llamada.
[in] wParam
Especifica un valor de 32 bits definido por la aplicación que identifica el tipo de notificación. Si este parámetro es igual a cero, hay un mensaje SNMP disponible para la sesión. La aplicación debe llamar a la función SnmpRecvMsg para recuperar el mensaje. Si este parámetro no es igual a cero, indica una notificación de eventos asincrónica para la sesión. Para obtener más información, vea la siguiente sección Comentarios.
[in] lParam
Especifica un valor de 32 bits definido por la aplicación que especifica el identificador de solicitud de la PDU que se está procesando.
[in] lpClientData
Si el parámetro lpClientData no era NULL en la llamada a la función SnmpCreateSession para esta sesión, este parámetro es un puntero a los datos definidos por la aplicación.
Valor devuelto
La función debe devolver SNMPAPI_SUCCESS para continuar la ejecución de la aplicación. Si la función devuelve cualquier otro valor, la implementación responde como si la aplicación llamara a la función SnmpClose para la sesión indicada.
Comentarios
Cuando la implementación ejecuta la directiva de retransmisión para la aplicación WinSNMP y se produce un tiempo de espera de transmisión, la implementación informa a la sesión del error. En esta situación, el valor del parámetro wParam sería SNMPAPI_TL_TIMEOUT. Para obtener una lista de otros errores de capa de transporte, consulte las páginas de referencia de las funciones SnmpRegister, SnmpSendMsg y SnmpRecvMsg .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winsnmp.h |