ISSONotification.ReceiveNotification, méthode

Article
07/21/2023

Reçoit une notification du système ENTSSO, telle que des modifications de mot de passe.

Syntaxe

  
HRESULT ReceiveNotification(  
ULONG ulNotificationFlagsIn,  
SReceiveNotification* pReceiveNotification,  
GUID* pguidTrackingId  
);

Paramètres

bstrAdapterName
[in] Nom unique de l'adaptateur.

ulNotificationFlagsIn
[in] Indicateurs de contrôle de la notification, de l'énumération SSO_NOTIFICATION_FLAG.

pReceiveNotification
[in] Pointeur de la notification reçue.

pguidTrackingId
[out] ID de suivi. Le système ENTSSO génère un ID de suivi et le retourne à l’appelant. Cet ID sert à des fins d'audit et peut également être utilisé par l'adaptateur pour associer les réponses aux requêtes. Ce paramètre peut être NULL si l'ID de suivi n'est pas requis par l'adaptateur.

Valeur renvoyée

Cette méthode retourne un HRESULT indiquant s’il s’est terminé correctement. Pour plus d'informations, voir la section Valeurs d'erreur.

Valeurs d'erreur

Cette méthode retourne un HRESULT contenant l’une des valeurs du tableau suivant.

Valeur	Description
S_OK	La méthode a réussi.
E_ACCESSDENIED	L’accès est refusé.
ENTSSO_E_NO_SERVER	Impossible de contacter le serveur ENTSSO. Vérifiez que le service ENTSSO est en cours d'exécution.
ENTSSO_E_NO_NOTIFICATIONS	Aucune notification à recevoir.
ENTSSO_E_WRONG_STATE	L'état de cette méthode appelée n'est pas correct.

Remarques

Vous pouvez utiliser ReceiveNotification pour recevoir à la fois les modifications de mot de passe et d’autres notifications du système ENTSSO.

Vous pouvez appeler ReceiveNotification avec ou sans indicateur WAIT. Si vous spécifiez l’indicateur WAIT, ReceiveNotification est bloqué jusqu’à ce qu’une notification soit disponible. Cela vous permet de déterminer si vous souhaitez dédier un thread pour recevoir des notifications du service ENTSSO ou si vous souhaitez utiliser le handle d’événements retourné par InitializeAdapter pour effectuer vos propres attentes, partagées avec d’autres événements.

Si ReceiveNotification est en attente lorsque vous appelez ShutdownAdapter, ReceiveNotification retourne une notification SHUTDOWN comme dernière notification. Cette notification prévaut sur toute autre notification en cours.

Il est possible que plusieurs threads appellent ReceiveNotification pour le même nom d’adaptateur. Dans ce cas, la requête est monothread au niveau du service ENTSSO, et une seule réceptionNotification se termine avec des informations valides. Les threads se terminent avec la notification suivante ou aucune notification, car chacun d'eux attend le même événement.

Configuration requise

Plates-formes: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 et Windows 10

Voir aussi

ISSONotification, interface (COM)
Membres de ISSONotification
Programmation avec l’authentification unique de l’entreprise

Partager via