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

資格情報プロバイダー駆動型 Windows ログオン エクスペリエンス

Windows 10の資格情報プロバイダー

ICredentialProviderCredential