SNMPAPI_CALLBACK fonction de rappel (winsnmp.h)
[SNMP est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt Windows Remote Management, qui est l’implémentation Microsoft de WS-Man.]
L’implémentation De Microsoft WinSNMP appelle la fonction SNMPAPI_CALLBACK pour notifier une session WinSNMP qu’un message SNMP ou un événement asynchrone est disponible.
SNMPAPI_CALLBACK est un espace réservé pour un nom de fonction de rappel défini par l’application ou la bibliothèque.
Syntaxe
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
)
{...}
Paramètres
[in] hSession
Gérez la session WinSNMP.
[in] hWnd
Gérez vers une fenêtre de l’application WinSNMP pour notifier lorsqu’une demande asynchrone se termine ou quand une notification d’interruption se produit. Ce paramètre n’a pas d’importance pour la session WinSNMP, mais l’implémentation transmet toujours la valeur à la fonction de rappel.
[in] wMsg
Spécifie un entier non signé qui identifie le message de notification à envoyer à la fenêtre de l’application WinSNMP. Ce paramètre n’a pas d’importance pour la session WinSNMP, mais l’implémentation transmet toujours la valeur à la fonction de rappel.
[in] wParam
Spécifie une valeur 32 bits définie par l’application qui identifie le type de notification. Si ce paramètre est égal à zéro, un message SNMP est disponible pour la session. L’application doit appeler la fonction SnmpRecvMsg pour récupérer le message. Si ce paramètre n’est pas égal à zéro, il indique une notification d’événement asynchrone pour la session. Pour plus d’informations, consultez la section Remarques suivante.
[in] lParam
Spécifie une valeur 32 bits définie par l’application qui spécifie l’identificateur de demande de la PDU en cours de traitement.
[in] lpClientData
Si le paramètre lpClientData n’était pas NULL sur l’appel à la fonction SnmpCreateSession pour cette session, ce paramètre est un pointeur vers des données définies par l’application.
Valeur retournée
La fonction doit retourner SNMPAPI_SUCCESS pour poursuivre l’exécution de l’application. Si la fonction retourne une autre valeur, l’implémentation répond comme si l’application appelait la fonction SnmpClose pour la session indiquée.
Remarques
Lorsque l’implémentation exécute la stratégie de retransmission pour l’application WinSNMP et qu’un délai d’attente de transmission se produit, l’implémentation informe la session de l’erreur. Dans ce cas, la valeur du paramètre wParam serait SNMPAPI_TL_TIMEOUT. Pour obtenir la liste des autres erreurs de couche de transport, consultez les pages de référence pour les fonctions SnmpRegister, SnmpSendMsg et SnmpRecvMsg .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winsnmp.h |