ICredentialProviderCredentialEvents2 インターフェイス (credentialprovider.h)
ICredentialProviderCredentialEvents インターフェイスを拡張し、Logon UI または Credential UI のフィールドのバッチ更新を可能にするメソッドを追加します。
継承
ICredentialProviderCredentialEvents2 インターフェイスは、ICredentialProviderCredentialEvents から継承されます。 ICredentialProviderCredentialEvents2 には、次の種類のメンバーもあります。
メソッド
ICredentialProviderCredentialEvents2 インターフェイスには、これらのメソッドがあります。
| ICredentialProviderCredentialEvents2::BeginFieldUpdates ログオンまたは資格情報 UI のフィールドへのバッチ更新を開始します。 |
| ICredentialProviderCredentialEvents2::EndFieldUpdates BeginFieldUpdates によって開始されたバッチ更新を完了してコミットします。 |
| ICredentialProviderCredentialEvents2::SetFieldOptions ログオン UI または資格情報 UI の指定されたフィールドに "パスワードの表示" グリフを表示するか、電子メール アドレスを受信する必要があるかどうかを指定します。 |
解説
Windows 7 と Windows Vista では、多くの資格情報プロバイダー が ICredentialProviderEvents::CredentialsChanged を使用して UI を更新しました。 これは機能しますが、呼び出し元の資格情報プロバイダーからのすべての資格情報を再列挙します。 このイベントの処理は、状況によっては、この再列挙による UI の点滅やフォーカスの変更につながる可能性があります。 そのため、UI の更新にのみ ICredentialProviderEvents::CredentialsChanged を使用することはお勧めしません。 新しい推奨事項は次のとおりです。
- ICredentialProviderEvents::CredentialsChanged は、資格情報プロバイダーがユーザーに自動的にログオンする必要がある場合、または列挙する資格情報の数を変更する必要がある場合にのみ使用します。
- 資格情報プロバイダーの UI を更新するには、 ICredentialProviderCredentialEvents2 を使用します。
バックグラウンド スレッドと対話する場合、 ICredentialProviderCredentialEvents2 の使用は、適切なスレッド間通信メソッドを使用する必要がある点で、 ICredentialProviderCredentialEvents の使用と似ています。
実装するタイミング
サード パーティはこのインターフェイスを実装しません。 このオブジェクトを取得するには、ICredentialProviderCredentialEvents で QueryInterface メソッドを呼び出します。要件
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | credentialprovider.h |