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.
Empfängt eine Benachrichtigung des ENTSSO-Systems, wie z. B. Kennwortänderungen.
Syntax
HRESULT ReceiveNotification(
ULONG ulNotificationFlagsIn,
SReceiveNotification* pReceiveNotification,
GUID* pguidTrackingId
);
Parameter
bstrAdapterName
[in] Der eindeutige Adaptername.
ulNotificationFlagsIn
[in] Die Benachrichtigungsflags zum Steuern dieser Benachrichtigung aus der Enumeration SSO_NOTIFICATION_FLAG.
pReceiveNotification
[in] Zeiger für die empfangene Benachrichtigung.
pguidTrackingId
[out] Die Nachverfolgungs-ID. Das ENTSSO-System generiert eine Nachverfolgungs-ID und gibt sie an den Aufrufer zurück. Die Überwachungs-ID wird nicht nur für Überwachungszwecke verwendet, mit ihr können außerdem vom Adapter Antworten auf Anfragen korreliert werden. Der Wert dieses Parameters kann NULL sein, wenn die Überwachungs-ID für den Adapter nicht erforderlich ist.
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_NO_NOTIFICATIONS | Es sind keine zu empfangenden Benachrichtigungen vorhanden. |
| ENTSSO_E_WRONG_STATE | Diese Methode wurde im falschen Status aufgerufen. |
Hinweise
Sie können ReceiveNotification verwenden, um Sowohl Kennwortänderungen als auch andere Benachrichtigungen vom ENTSSO-System zu erhalten.
Sie können ReceiveNotification mit oder ohne WAIT-Flag aufrufen. Wenn Sie das WAIT-Flag angeben, blockiert ReceiveNotification , bis eine Benachrichtigung verfügbar ist. Auf diese Weise können Sie ermitteln, ob Sie einen Thread für den Empfang von Benachrichtigungen vom ENTSSO-Dienst verwenden möchten, oder ob Sie das ereignisbasierte Handle verwenden möchten, das von InitializeAdapter zurückgegeben wurde, um eigene Wartevorgänge auszuführen, die für andere Ereignisse freigegeben werden.
Wenn ReceiveNotification wartet, wenn Sie ShutdownAdapter aufrufen, gibt ReceiveNotification als letzte Benachrichtigung eine SHUTDOWN-Benachrichtigung zurück. Die Benachrichtigung für das Herunterfahren hat Vorrang vor allen anderen ausstehenden Benachrichtigungen.
Es ist möglich, dass mehrere Threads ReceiveNotification für denselben Adapternamen aufrufen. In diesem Fall wird die Anforderung im Singlethread beim ENTSSO-Dienst ausgeführt, und nur eine ReceiveNotification wird mit gültigen Informationen abgeschlossen. Die Threads werden entweder mit der nächsten Benachrichtigung oder mit KEINE abgeschlossen, da jeder dieser Threads auf das gleiche Ereignis wartet.
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