ICredentialProviderCredential2 インターフェイス (credentialprovider.h)
ユーザーのセキュリティ識別子 (SID) を取得するメソッドを追加することで、 ICredentialProviderCredential インターフェイスを拡張します。 資格情報はそのユーザーに関連付けられているので、ユーザーのタイルの下にグループ化できます。
継承
ICredentialProviderCredential2 インターフェイスは、ICredentialProviderCredential から継承されます。 ICredentialProviderCredential2 には、次の種類のメンバーもあります。
メソッド
ICredentialProviderCredential2 インターフェイスには、これらのメソッドがあります。
| ICredentialProviderCredential2::GetUserSid この資格情報に関連付けられているユーザーのセキュリティ識別子 (SID) を取得します。 |
解説
このクラスは、V2 資格情報プロバイダーを作成するために必要です。 V2 資格情報プロバイダーは、ユーザーに対してパーソナライズされたログオン エクスペリエンスを提供します。 これは、ユーザーが使用できるサインイン オプションをログオン UI に伝える資格情報プロバイダーによって発生します。 新しい資格情報プロバイダーは V2 資格情報プロバイダーにすることをお勧めします。
ICredentialProviderCredential2 インスタンスを作成するには、GetUserSid 関数によって有効な SID が返される必要があります。 Valid は、ログオン UI によって現在列挙されているいずれかのユーザーに対して返される SID によって定義されます。
使用可能なユーザーを取得し、関連付けるユーザーを決定するための便利なツールは、 ICredentialProviderUserArray オブジェクトです。 このオブジェクトには、列挙されるユーザーに関する情報を取得するためにクエリを実行できる ICredentialProviderUser オブジェクトの一覧が含まれています。 たとえば、 GetStringValue を使用して、それぞれ PKEY_Identity_PrimarySid または PKEY_Identity_USerName のパラメーターで渡されたユーザーの SID またはユーザー名 を 取得できます。 SetProviderFilter を使用して結果をフィルター処理して、使用可能なユーザーのサブセットのみを表示することもできます。
ICredentialProviderUserArray の使用は省略可能ですが、有効な SID 値を作成するために必要な情報を取得する便利な方法です。 ログオン UI によって列挙されるユーザーの一覧を取得するには、ICredentialProviderSetUserArray インターフェイスを実装して、SetUserArray から ICredentialProviderUserArray オブジェクトを取得します。 ログオン UI は GetCredentialCount の前に SetUserArray を呼び出します。そのため、資格情報プロバイダーが資格情報を返す際に ICredentialProviderUserArray オブジェクトの準備が整います。
V2 資格情報プロバイダーは、[サインイン オプション] リンクの下に表示されるアイコンで表されます。 資格情報プロバイダーのアイコンを提供するには、資格情報自体に CPFT_TILE_IMAGE の CREDENTIAL_PROVIDER_FIELD_TYPE を定義します。 次に、CREDENTIAL_PROVIDER_FIELD_DESCRIPTORの guidFieldType が CPFG_CREDENTIAL_PROVIDER_LOGO に設定されていることを確認します。 アイコンの推奨サイズは 72 x 72 ピクセルです。
資格情報プロバイダーのアイコンを指定するのと同様に、資格情報プロバイダーを識別するテキスト文字列を指定することもできます。 この文字列は、ユーザーがアイコンの上にマウス ポインターを合わせると、ポップアップ ウィンドウに表示されます。 これを行うには、資格情報自体に CPFT_SMALL_TEXT の CREDENTIAL_PROVIDER_FIELD_TYPE を定義します。 次に、CREDENTIAL_PROVIDER_FIELD_DESCRIPTORの guidFieldType が CPFG_CREDENTIAL_PROVIDER_LABEL に設定されていることを確認します。 この文字列は、上記の資格情報プロバイダー アイコンを補完し、ユーザーがそれが何であるかを理解するのに十分な説明を示す必要があります。 たとえば、画像パスワード プロバイダーの説明は "Picture Password" です。
実装するタイミング
ログオン UI で資格情報タイルを特定のユーザー タイルに関連付けるには、このインターフェイスを実装します。要件
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | credentialprovider.h |