Structure NOTIFYINFO (npapi.h)

La structure NOTIFYINFO contient status informations sur une opération de connexion ou de déconnexion réseau. Il est utilisé par les fonctions AddConnectNotify et CancelConnectNotify .

Syntaxe

typedef struct _NOTIFYINFO {
  DWORD  dwNotifyStatus;
  DWORD  dwOperationStatus;
  LPVOID lpContext;
} NOTIFYINFO, *LPNOTIFYINFO;

Membres

dwNotifyStatus

Ce sera NOTIFY_PRE ou NOTIFY_POST pour indiquer si cette notification est envoyée avant ou après l’exécution de la connexion ou de la déconnexion.

dwOperationStatus

Cette valeur est définie sur WN_SUCCESS lorsque dwNotifyStatus est NOTIFY_PRE.

Si dwNotifyStatus a la valeur NOTIFY_POST, dwOperationStatus contient le code de retour status de la fonction effectuant l’opération : NPAddConnection ou NPCancelConnection.

lpContext

Utilisé par l’application qui reçoit la notification afin de conserver un contexte pour l’opération entre la pré-notification et les appels post-notification. En d’autres termes, elle permet à l’application de notification de faire correspondre l’appel de notification préalable à l’appel de notification après-coup correspondant pour un événement particulier. Le membre lpContext est un pointeur NULL lorsque la fonction de notification est appelée pour une notification préalable. La fonction de notification peut retourner avec lpContext toujours NULL, ce qui indique qu’elle n’est pas intéressée par une notification supplémentaire pour cette opération spécifique. Dans ce cas, la fonction de notification n’est pas appelée à nouveau avec la notification après-coup pour cette opération. Si l’appel de la fonction de notification anticipée retourne une valeur non NULL dans lpContext, cette valeur est transmise lorsque la fonction de notification est appelée pour la notification après-le-fait pour cette même opération.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	npapi.h