ISSONotification.ReceiveNotification メソッド

パスワード変更などの通知を 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 サービスでシングル スレッドであり、有効な情報で完了する ReceiveNotification は 1 つだけです。 スレッドは次の通知または [なし] で処理されます。 これは、これらのスレッドが同じイベントを待機しているためです。

要件

プラットフォーム：Windows Server 2022、Windows Server 2019、Windows Server 2016、Windows 11、Windows 10

参照

ISSONotification インターフェイス (COM)
ISSONotification メンバー
Enterprise Single Sign-On によるプログラミング