Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Sendet eine Benachrichtigung vom Adapter an das ENTSSO-System, wie z. B. eine Kennwortänderung.
Syntax
HRESULT SendNotification(
SSendNotification SendNotification,
GUID* pguidTrackingId
);
Parameter
SendNotification
[in] Die Benachrichtigung, die vom Adapter zum ENTSSO gesendet werden soll.
pguidTrackingId
[out] Enthält beim Beenden der Methode die von ENTSSO generierte Überwachungs-ID. Sie können die Überwachungs-ID für Überwachungszwecke oder zur Korrelation von Anforderungsantworten verwenden. Kann NULL sein.
Rückgabewert
Diese Methode gibt ein HRESULT zurück, durch das angegeben wird, ob die Methode richtig abgeschlossen wurde. Weitere Informationen finden Sie im Abschnitt "Fehlerwerte".
Fehlerwerte
Diese Methode gibt ein HRESULT zurück, das einen der Werte in der folgenden Tabelle enthält.
| Wert | BESCHREIBUNG |
|---|---|
| S_OK | Die Methode war erfolgreich. |
| E_ACCESSDENIED | Zugriff verweigert.“ |
| ENTSSO_E_NO_SERVER | Zum ENTSSO-Server konnte keine Verbindung hergestellt werden. Überprüfen Sie, ob der ENTSSO-Dienst ausgeführt wird. |
| ENTSSO_E_WRONG_STATE | Diese Methode wurde im falschen Status aufgerufen. |
| ENTSSO_E_INVALID_NOTIFICATION | Ungültiger Benachrichtigungstyp. |
Hinweise
Sie können SendNotification verwenden, um Kennwortänderungen und andere Benachrichtigungen an das ENTSSO-System zu senden.
Wenn SendNotification S_OK zurückgibt, bedeutet dies nicht, dass eine Kennwortänderung auf dem Zielsystem abgeschlossen wurde. Stattdessen besagt der Empfang von S_OK, dass die Anforderung von ENTSSO akzeptiert wurde und später ausgeführt wird.
Eine Kennwortänderung von einem externen System aus kann mehrere Konsequenzen nach sich ziehen:
Wenn eine partielle Kennwortsynchronisierung konfiguriert ist, wird die SSO-Datenbank möglicherweise aktualisiert, sofern für das externe Konto eine aktuelle Zuordnung vorhanden ist.
Wenn eine vollständige Kennwortsynchronisierung konfiguriert ist, wird die Kennwortänderung möglicherweise auch für ein Windows-Konto vorgenommen.
Wenn für das externe Konto keine aktuelle Zuordnung vorhanden ist, hat die Kennwortänderung möglicherweise keine Auswirkungen.
Die Benachrichtigung, dass die Kennwortänderung ausgeführt wurde, wird ausgegeben, wenn die Kennwortänderung aus Sicht von ENTSSO abgeschlossen ist. Wie weiter oben erläutert, kann das verschiedene Bedeutungen haben. In manchen Fällen bedeutet es, dass keine Änderung vorgenommen wurde, dass nur die SSO-Datenbank aktualisiert wurde oder dass das Windows-Kennwort geändert wurde.
Beachten Sie, dass an den Adapter zurückgesendete Benachrichtigungen über die ausgeführte Kennwortänderung nicht absolut zuverlässig sind. Unter einigen Fehlerbedingungen empfängt das Einmalige Anmelden (SSO) die angeforderten Benachrichtigungen möglicherweise gar nicht.
In ENTSSO ist die Definition von Anmeldeinformationen, wie sie von SendNotification für Kennwortaktualisierungen gesendet werden, flexibler als ein einfaches Kennwort. Wenn Sie eine SSO-Anwendung definieren, definieren Sie auch die Felder mit den Anmeldeinformationen. Die Felder geben die Bezeichnungen an, die für die UI-Felder verwendet werden sollen und geben an, ob diese Felder maskiert sind oder nicht. Zusätzlich gibt es ein spezielles Flag zum Angeben, ob das Feld synchronisiert werden soll oder nicht. Feld 0 ist ein Sonderfall und definiert die Bezeichnung für die Benutzer-ID. Weitere Informationen finden Sie unter ISSOAdmin-Schnittstelle.
Anforderungen
Plattformen: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 und Windows 10
Weitere Informationen
ISSONotification-Schnittstelle (COM)
ISSONotification-Member
Programmieren mit Einmaligem Anmelden für Unternehmen