次の方法で共有


ICredentialProviderEvents::CredentialsChanged メソッド (credentialprovider.h)

資格情報の列挙リストが変更されたことをログオン UI または資格情報 UI に通知します。 これは、資格情報の数が変更された場合、個々の資格情報が変更された場合、または使用可能なフィールドの数が変更された場合に発生します。 これは非同期メソッドです。

構文

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

パラメーター

[in] upAdviseContext

種類: UINT_PTR

再列挙を要求した資格情報プロバイダーを一意に識別する整数へのポインター。 資格情報プロバイダーは、このパラメーターの Advise から受信したインターフェイス ポインターを返す必要があります。

戻り値

型: HRESULT

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

注釈

以前は、多くの資格情報プロバイダー が ICredentialProviderEvents::CredentialsChanged を使用して UI を更新しました。 これは機能しますが、呼び出し元の資格情報プロバイダーからのすべての資格情報が再列挙されます。 このイベントを処理すると、状況によっては、この再列挙が原因で UI の点滅やフォーカスの変更が発生する可能性があります。 そのため、UI の更新にのみ ICredentialProviderEvents::CredentialsChanged を使用することはお勧めしません。 新しい推奨事項は次のとおりです。

  • ICredentialProviderEvents::CredentialsChanged は、資格情報プロバイダーが自動ログオンを行うか、列挙している資格情報の数を変更する必要がある場合にのみ使用します。
  • 資格情報プロバイダーのログオン UI または資格情報 UI を更新するには、 ICredentialProviderCredentialEvents2 を使用します。

要件

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