ICredentialProvider::Advise メソッド (credentialprovider.h)

資格情報プロバイダーがコールバック インターフェイスを介してログオン UI または資格情報 UI でイベントを開始できるようにします。

構文

HRESULT Advise(
  [in] ICredentialProviderEvents *pcpe,
  [in] UINT_PTR                  upAdviseContext
);

パラメーター

[in] pcpe

種類: ICredentialProviderEvents*

通知メカニズムとして使用 される ICredentialProviderEvents コールバック インターフェイスへのポインター。

[in] upAdviseContext

種類: UINT_PTR

再列挙を要求した資格情報プロバイダーを一意に識別する整数へのポインター。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

メソッドを実装する必要はありません。実装されていない場合は 、E_NOTIMPL を返す必要があります。 ログオン UI または資格情報 UI が変更または更新されない場合など、呼び出す理由がない可能性があります。

このメソッドを使用すると、ログオン UI と資格情報 UI で 、資格情報プロバイダーに ICredentialProviderEvents ポインターを渡すことができます。 これにより、資格情報プロバイダーは、ログオンまたは資格情報 UI との非同期コールバック通信を行うことができます。 たとえば、スマート カード プロバイダーは、新しいスマート カードが挿入されたときに資格情報をもう一度列挙する必要がある場合があります。 ログオン UI をトリガーして資格情報をもう一度取得するには、資格情報プロバイダーは、upAdviseContext 識別子を指定して CredentialsChanged を呼び出す必要があります。

このメソッドを実装する資格情報プロバイダーは、指定された ICredentialProviderEvents で AddRef を呼び出す必要があります。 これらの資格情報プロバイダーは、UnAdvise メソッド中に Release を呼び出す必要もあります。

要件

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

関連項目

ICredentialProvider

ICredentialProvider::UnAdvise