IIdentityProvider::Advise メソッド (identityprovider.h)

  • [アーティクル]

Advise メソッドを使用すると、呼び出し元のアプリケーションで、アプリケーションに通知する ID イベントの一覧を指定できます。

構文

HRESULT Advise(
  [in]  IIdentityAdvise *pIdentityAdvise,
  [in]  DWORD           dwIdentityUpdateEvents,
  [out] DWORD           *pdwCookie
);

パラメーター

[in] pIdentityAdvise

呼び出し元のアプリケーションによって実装される IIdentityAdvise インターフェイスへのポインター。 このインターフェイスは、 dwIdentityUpdateEvents パラメーターで指定されたイベントのいずれかが発生したときに ID プロバイダーが呼び出すことができるメソッドを提供します。

[in] dwIdentityUpdateEvents

呼び出し元アプリケーションに通知する ID イベント。 このパラメーターの値は、ビットごとの OR 演算を使用して結合された次の値の 0 個以上にすることができます。

値 説明
IDENTITY_ASSOCIATED
0X0001
 ID が ID プロバイダーに関連付けられていた。
IDENTITY_DISASSOCIATED
0X0002
 ID が ID プロバイダーから関連付け解除されました。
IDENTITY_CREATED
0X0004
 新しい ID が作成されました。
IDENTITY_IMPORTED
0X0008
 ID が別の ID プロバイダーからインポートされました。
IDENTITY_DELETED
0X0010
 ID ストアから ID が削除されました。
IDENTITY_PROPCHANGE
0X0020
 ID のプロパティの値が変更されました。

[out] pdwCookie

この接続を識別する値へのポインター。 この接続の使用が完了したら、この値を UnAdvise メソッドに渡して削除します。

戻り値

メソッドが成功すると、 S_OKが返されます。

メソッドが失敗すると、エラー コードが返されます。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー identityprovider.h

関連項目

IIdentityAdvise::IdentityUpdated

IIdentityProvider