ISSOWrapper.ReceiveNotification, méthode
Reçoit une notification pour l'adaptateur depuis le service ENTSSO.
Syntaxe
void ReceiveNotification(
ULONG ulNotificationFlagsIn,
GUID guidTrackingIdIn,
out ULONG *pulNotificationType,
out ULONG *pulNotificationFlagsOut,
out BSTR *pbstrExternalAccount,
out BSTR *pbstrNewExternalPassword,
out BSTR *pbstrOldExternalPassword,
out ULONGLONG *pullTimestamp,
out ULONGLONG *pullErrorCode,
out BSTR *pbstrErrorMessage,
out SAFEARRAY(BSTR) *ppsaAdapters,
out BSTR *pbstrAdapterName,
out GUID *pguidTrackingIdOut
);
Paramètres
| Paramètre | Description |
|---|---|
ulNotificationFlagsIn |
Indicateurs de notification. Indiquez la valeur SSO_NOTIFICATION_FLAG_WAIT si vous voulez que votre appel soit bloqué dans l'attente d'une notification. Autrement, spécifiez SSO_NOTIFICATION_FLAG_NONE. |
guidTrackingIdIn |
ID de suivi. |
pulNnotificationType |
Au retour, contient un pointeur vers un ULONG permettant de recevoir le type de notification. |
pulNotificationFlagsOut |
Au retour, contient un pointeur vers un ULONG permettant de recevoir les indicateurs de notification. |
pbstrExternalAccount |
Au retour, contient le compte externe pour lequel le mot de passe doit être changé. |
newExternalPassword |
Au retour, contient le nouveau mot de passe du compte externe. |
pbstrOldExternalPassword |
facultatif. Au retour, contient l'ancien mot de passe du compte externe. |
pullTimestamp |
Au retour, contient la date et l'heure de modification du mot de passe. |
pullErrorCode |
Au retour, contient le code de l'erreur. |
pbstrErrorMessage |
Au retour, contient un message d'erreur. |
ppsaAdapters |
Au retour, contient un tableau de noms d'adaptateurs. |
pbstrAdapterName |
Au retour, contient le nom de l'adaptateur. |
pbuidTrackingIdOut |
Au retour, contient l'ID de suivi. |
Valeur renvoyée
Cette méthode retourne une valeur HRESULT indiquant si elle s’est terminée correctement. Pour plus d'informations, voir la section Exceptions.
Exceptions
E_ACCESS_DENIED
L’accès est refusé.
Remarques
ReceiveNotification utilise des paramètres différents pour retourner les informations, en fonction du notificationType. Le tableau ci-dessous décrit la relation entre les différents paramètres et les types de notifications.
| notificationType | Paramètres |
|---|---|
| SSO_NOTIFICATION_TYPE_PASSWORD_CHANGE | externalAccount newExternalPassword oldExternalPassword timestamp |
| SSO_NOTIFICATION_TYPE_PASSWORD_CHANGE_COMPLETE | trackingIdIn errorCode errorMessage |
| SSO_NOTIFICATION_TYPE_STATUS_OFFLINE | errorCode errorMessage |
| SSO_NOTIFICATION_TYPE_PASSWORD_EXPIRED | externalAccount |
| SSO_NOTIFICATION_TYPE_STATUS_REQUEST | None |
| SSO_NOTIFICATION_TYPE_STATUS_ONLINE | None |