ISSONotification.SendNotification, méthode
Envoie une notification, telle qu'une modification de mot de passe, de l'adaptateur vers le système ENTSSO.
Syntaxe
HRESULT SendNotification(
SSendNotification SendNotification,
GUID* pguidTrackingId
);
Paramètres
SendNotification
[in] Notification à envoyer de l'adaptateur au système ENTSSO.
pguidTrackingId
[out] Lorsque cette méthode est retournée, contient l'ID de suivi généré par le service ENTSSO. Vous pouvez utiliser l'ID à des fins d'audit ou pour corréler la requête et les réponses. Peut être NULL.
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_WRONG_STATE | L'état de cette méthode appelée n'est pas correct. |
| ENTSSO_E_INVALID_NOTIFICATION | Type de notification non valide. |
Remarques
Vous pouvez utiliser SendNotification pour envoyer des modifications de mot de passe et d’autres notifications au système ENTSSO.
Si SendNotification retourne S_OK, cela ne signifie pas qu’une modification de mot de passe a été effectuée sur le système de destination. Par contre, la réception de S_OK indique que ENTSSO a accepté et traitera par la suite votre requête.
Une modification de mot de passe à partir d'un système externe peut avoir plusieurs conséquences :
Si une synchronisation de mot de passe partielle est configurée, la base de données SSO pourra être mises à jour, à condition qu'un mappage actif existe pour le compte externe.
Si une synchronisation de mot de passe complète est configurée, la modification de mot de passe pourra également être apportée à un compte Windows.
Si le compte externe n'a pas de mappage actif dans la base de données SSO, la modification de mot de passe pourra n'avoir aucun effet.
La notification d'exécution de modification de mot de passe est émise lorsque ENTSSO considère que la modification a été apportée, ce qui, comme nous l'avons vu précédemment, peut signifier différentes choses. Dans certains cas, cela peut signifier qu'aucune modification n'a été apportée, que seule la base de données SSO a été mise à jour, ou que le mot de passe Windows a été modifié.
Notez que les notifications d'exécution de modification de mot de passe renvoyées à l'adaptateur ne sont pas complètement fiables. Dans certaines conditions d'erreur, SSO peut ne jamais recevoir réellement les notifications demandées.
Dans ENTSSO, la définition des informations d’identification, telles que celles envoyées par SendNotification pour les mises à jour de mot de passe, est plus flexible qu’un simple mot de passe. Lorsque vous définissez une application SSO, vous définissez également les champs d'informations d'identification. Ces champs identifient les étiquettes à utiliser pour les champs de l'interface utilisateur, et si ces champs sont ou non masqués. Par ailleurs, un indicateur spécial spécifie si le champs doit être ou non synchronisé. Le champ 0 est un cas spécial qui définit l’étiquette de l’ID utilisateur. Pour plus d’informations, consultez l’interface ISSOAdmin.
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