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;

Members

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を使用して、必要に応じてフィールドを非表示または表示します。

Requirements