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 で定義されています。

解説

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

要件