パスワードの変更など、ENTSSO システムから通知を受信します。
構文
HRESULT ReceiveNotification(
ULONG ulNotificationFlagsIn,
SReceiveNotification* pReceiveNotification,
GUID* pguidTrackingId
);
パラメーター
bstrAdapterName
[in]一意のアダプター名。
ulNotificationFlagsIn
[in]SSO_NOTIFICATION_FLAG列挙体から、この通知を制御する通知フラグ。
pReceiveNotification
[in]受信した通知のポインター。
pguidTrackingId
[out]追跡 ID。 ENTSSO システムによって追跡 ID が生成され、呼び出し元に返されます。 追跡 ID は監査目的で使用され、アダプターが応答を要求に関連付けるために使用することもできます。 アダプターで追跡 ID が必要ない場合、このパラメーターは NULL にすることができます。
戻り値
このメソッドは、正常に完了したかどうかを示す HRESULT を返します。 詳細については、「エラー値」セクションを参照してください。
エラー値
このメソッドは、次の表のいずれかの値を含む HRESULT を返します。
| 価値 | 説明 |
|---|---|
| S_OK | メソッドが成功しました。 |
| E_ACCESSDENIED | アクセスが拒否されました。 |
| ENTSSO_E_NO_SERVER | ENTSSO サーバーに接続できませんでした。 ENTSSO サービスが実行されていることを確認します。 |
| ENTSSO_E_NO_NOTIFICATIONS | 受信する通知はありません。 |
| ENTSSO_E_WRONG_STATE | このメソッドが間違った状態で呼び出されました。 |
注釈
ReceiveNotification を使用して、ENTSSO システムからパスワードの変更とその他の通知の両方を受信できます。
WAIT フラグの有無にかかわらず ReceiveNotification を呼び出す場合があります。 WAIT フラグを指定した場合、 ReceiveNotification は通知が使用可能になるまでブロックします。 これにより、ENTSSO サービスからの通知を受信するためのスレッドを専用にするかどうか、または InitializeAdapter から返されたイベント ハンドルを使用して他のイベントと共有される独自の待機を実行するかどうかを判断できます。
ShutdownAdapter を呼び出すときに ReceiveNotification が待機している場合、ReceiveNotification は最後の通知として SHUTDOWN 通知を返します。 SHUTDOWN 通知は、他の保留中の通知を優先します。
複数のスレッドが同じアダプター名に対して ReceiveNotification を呼び出している可能性があります。 この場合、要求は ENTSSO サービスでシングル スレッド化され、1 つの ReceiveNotification だけが有効な情報で完了します。 スレッドは、次の通知または NONE のいずれかで完了します。 その理由は、これらの各スレッドが同じイベントを待機するためです。
必要条件
プラットフォーム： Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11、Windows 10
こちらもご覧ください
ISSONotification インターフェイス (COM)
ISSONotification メンバー
Enterprise シングル サインオンを使用したプログラミング