CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR 構造体 (credentialprovider.h)

資格情報の 1 つのフィールドについて説明します。 たとえば、文字列やユーザー イメージなどです。

構文

typedef struct _CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR {
  DWORD                          dwFieldID;
  CREDENTIAL_PROVIDER_FIELD_TYPE cpft;
  LPWSTR                         pszLabel;
  GUID                           guidFieldType;
} CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR;

メンバー

dwFieldID

型: DWORD

フィールドの一意の ID。 フィールドには、特定の資格情報プロバイダー上の他のすべてのフィールドと比較した一意の識別子が必要です。 これは、フィールドが表示されるか非表示であるかに関係なく当てはまります。

cpft

種類: CREDENTIAL_PROVIDER_FIELD_TYPE

フィールドの型。

pszLabel

種類: LPWSTR

null で終わる Unicode 文字列としてフィールドのフレンドリ名を含むバッファーへのポインター。 これは、アクセシビリティとキューの目的で使用されます。 たとえば、一部の標準フィールドには、"Username"、"Password"、"Log On To" のフレンド名があります。

guidFieldType

種類: GUID

フィールドの種類を一意に識別する GUID。 このメンバーを使用すると、既存の資格情報プロバイダーによって提供される機能を独自のプロバイダーでラップできます。 資格情報プロバイダーのラップは、インボックス資格情報プロバイダーを無効にする予期しない動作につながる可能性があるため、推奨されません。

次の表は、Windows でサポートされている guidFieldType 値の一覧です。 これらは Shlguid.h で定義されています。

値	意味
CPFG_LOGON_USERNAME da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b	テキスト ボックスに入力されたユーザー名。
CPFG_LOGON_PASSWORD 60624cfa-a477-47b1-8a8e-3a4a19981827	テキスト ボックスに入力されたパスワード。
CPFG_SMARTCARD_USERNAME 3e1ecf69-568c-4d96-9d59-46444174e2d6	挿入されたスマート カードから取得したユーザー名。
CPFG_SMARTCARD_PIN 4fe5263b-9181-46c1-b0a4-9dedd4db7dea	挿入されたスマート カードから取得された PIN。
CPFG_CREDENTIAL_PROVIDER_LOGO 2d837775-f6cd-464e-a745-482fd0b47493	Windows 8 で導入: ログオン ページで資格情報プロバイダーを表すために使用されるイメージ。
CPFG_CREDENTIAL_PROVIDER_LABEL 286BBFF3-BAD4-438F-B007-79B7267C3D48	Windows 8 で導入: ログオン ページの資格情報プロバイダーに関連付けられているラベル。

解説

タイルでユーザーに表示される各 UI 要素は、資格情報プロバイダーによってフィールドとして定義されます。 CREDENTIAL_PROVIDER_FIELD_DESCRIPTORは、資格情報プロバイダーがフィールドを識別する方法です。 特定の使用シナリオに対してフィールドを定義した後は、フィールドをに追加したり、 から減算したりすることはできません。 資格情報プロバイダーは、タイルを列挙する前に、すべてのフィールドを完全に定義する必要があります。 資格情報取得プロセスの一環としてフィールドが表示または非表示になる場合でも、これらのフィールドは事前に定義されません。 CREDENTIAL_PROVIDER_FIELD_STATEを使用して、必要に応じてフィールドを非表示または表示します。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	credentialprovider.h