次の方法で共有

ISSONotification.SendNotification メソッド

  • [アーティクル]

パスワードの変更などの通知を、アダプターから ENTSSO システムに送信します。

構文

  
HRESULT SendNotification(  
SSendNotification SendNotification,  
GUID* pguidTrackingId  
);

パラメーター

SendNotification
[in] アダプターから ENTSSO システムに送信する通知。

pguidTrackingId
[out] このメソッドが完了すると、ENTSSO で生成された追跡 ID が格納されます。 追跡 ID は、監査、または要求の応答の関連付けに使用できます。 NULL の場合もあります。

戻り値

このメソッドは、正しく終了したかどうかを示す HRESULT を返します。 詳細については、「エラー値」のセクションを参照してください。

エラー値

このメソッドは、次の表のいずれかの値を含む HRESULT を返します。

値 説明
S_OK メソッドは正常に実行されました。
E_ACCESSDENIED アクセスが拒否されました。
ENTSSO_E_NO_SERVER ENTSSO サーバーに接続できませんでした。 ENTSSO サービスが実行中であることを確認してください。
ENTSSO_E_WRONG_STATE このメソッドは正しくない状態で呼び出されました。
ENTSSO_E_INVALID_NOTIFICATION 通知の種類が無効です。

注釈

SendNotification を使用して、パスワードの変更やその他の通知を ENTSSO システムに送信できます。

SendNotification がS_OKを返した場合、これは宛先システムでパスワードの変更が完了したことを意味するものではありません。 S_OK の受信は、ENTSSO で要求が承認され、いずれ完了することを意味します。

外部システムからのパスワードの変更は次のような影響をもたらす場合があります。

  • パスワードの部分同期が構成されている場合、その外部アカウントの現在のマッピングがあれば、SSO データベースが更新される可能性があります。

  • パスワードの完全同期が構成されている場合、パスワードの変更は、Windows アカウントにも反映される可能性があります。

    外部アカウントが SSO データベースに現在のマッピングを持っていない場合は、パスワードの変更が行われない可能性があります。

    パスワードの変更の完了通知は、ENTSSO 側でパスワードの変更が完了したと見なされたときに発行されます。上述のとおり、これにはさまざまな場合があります。 場合によっては、変更が行われなかったり、SSO データベースのみが更新されたり、Windows パスワードが変更されたりします。

    アダプターに送信されるパスワードの変更の完了通知は、完全に信頼できるものではないことに注意してください。 エラー状態によっては、シングル サインオンでは要求した通知を受信しないこともあります。

    ENTSSO では、パスワード更新のために SendNotification によって送信される資格情報などの資格情報の定義は、単純なパスワードよりも柔軟です。 SSO アプリケーションを定義するときに、資格情報フィールドも定義します。 これらのフィールドでは、UI フィールドに使用するラベルを識別し、それらのフィールドをマスクするかどうかを指定します。 さらに、フィールドを同期するかどうかを指定する特別なフラグもあります。 フィールド 0 は特殊なケースであり、ユーザー ID のラベルを定義します。 詳細については、 ISSOAdmin インターフェイスに関するページを参照してください。

要件

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

参照

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