Partager via


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

Voir aussi

SnmpClose

SnmpCreateSession

Fonctions WinSNMP

Vue d’ensemble de l’API WinSNMP