ICredentialProvider インターフェイス (credentialprovider.h)
資格情報プロバイダーのセットアップと操作で使用されるメソッドを公開します。 すべての資格情報プロバイダーは、このインターフェイスを実装する必要があります。
継承
ICredentialProvider インターフェイスは、IUnknown インターフェイスから継承します。 ICredentialProvider には、次の種類のメンバーもあります。
メソッド
ICredentialProvider インターフェイスには、これらのメソッドがあります。
| ICredentialProvider::Advise 資格情報プロバイダーがコールバック インターフェイスを介してログオン UI または資格情報 UI でイベントを開始できるようにします。 |
| ICredentialProvider::GetCredentialAt 特定の資格情報を取得します。 |
| ICredentialProvider::GetCredentialCount この資格情報プロバイダーで使用できる資格情報の数を取得します。 |
| ICredentialProvider::GetFieldDescriptorAt 指定したフィールドを記述するメタデータを取得します。 |
| ICredentialProvider::GetFieldDescriptorCount このプロバイダーの資格情報を表示するために必要な 内のフィールドの数を取得します。 |
| ICredentialProvider::SetSerialization 資格情報プロバイダーのシリアル化特性を設定します。 |
| ICredentialProvider::SetUsageScenario 資格情報プロバイダーが有効なシナリオを定義します。 資格情報プロバイダーが初期化されるたびに呼び出されます。 |
| ICredentialProvider::UnAdvise イベント コールバックが受け入れられなくなったことを資格情報プロバイダーに通知するために、ログオン UI または資格情報 UI によって使用されます。 |
解説
このインターフェイスは、アプリのログオン UI と資格情報 UI を操作する方法です。
インスタンス化された資格情報プロバイダーは、ログオン UI の有効期間全体にわたって維持されます。 このため、ログオン UI は資格情報プロバイダーの状態を維持できます。 特に、資格情報を指定したプロバイダーとタイルが記憶されます。 つまり、CPUS_LOGON、CPUS_UNLOCK_WORKSTATION、CPUS_CHANGE_PASSWORDのCREDENTIAL_PROVIDER_USAGE_SCENARIOを使用しているときに、状態情報を格納できる可能性があります。 これは、資格情報 UI では当てはまれません。 資格情報 UI は、アプリケーションが CredUIPromptForWindowsCredentials を呼び出すたびに、プロバイダーの新しいインスタンスを作成します。 このため、資格情報 UI は資格情報プロバイダーの状態を記憶できません。
1 つのシナリオで生成された CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION が保存され、後続の使用シナリオで使用される可能性があることに注意してください。 このため、 ICredentialProvider 実装がこのシナリオを処理するのに十分な堅牢性を持っていることを確認する必要があります。
Windows 8 では、資格情報プロバイダー API に新しい機能が追加されます。主に、ユーザー別に資格情報をグループ化する機能です。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | credentialprovider.h |
関連項目
CREDENTIAL_PROVIDER_USAGE_SCENARIO