CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR 구조체(credentialprovider.h)

자격 증명의 단일 필드를 설명합니다. 예를 들어 문자열 또는 사용자 이미지입니다.

구문

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로 끝나는 유니코드 문자열로 포함하는 버퍼에 대한 포인터입니다. 접근성 및 큐에 사용됩니다. 예를 들어 일부 표준 필드에는 "Username", "Password" 및 "Log On To"의 friend 이름이 있습니다.

guidFieldType

형식: GUID

필드 형식을 고유하게 식별하는 GUID입니다. 이 멤버를 사용하면 기존 자격 증명 공급자가 자체 공급자에서 제공하는 기능을 래핑할 수 있습니다. 자격 증명 공급자를 래핑하는 것은 기본 자격 증명 공급자를 사용하지 않도록 설정하는 예기치 않은 동작으로 이어질 수 있으므로 권장되지 않습니다.

다음 표에서는 Windows에서 지원하는 guidFieldType 값을 나열합니다. 이러한 항목은 Shlguid.h에 정의되어 있습니다.

설명

타일에서 사용자에게 표시되는 각 UI 요소는 자격 증명 공급자가 필드로 정의합니다. CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR 자격 증명 공급자가 필드를 식별하는 방법입니다. 특정 사용 시나리오에 대해 필드를 정의한 후에는 필드를 에 추가하거나 뺄 수 없습니다. 자격 증명 공급자는 타일을 열거하기 전에 모든 필드를 완전히 정의해야 합니다. 자격 증명 획득 프로세스의 일부로 필드가 표시되거나 사라질 경우 해당 필드는 미리 정의되지 않습니다. 필요에 따라 CREDENTIAL_PROVIDER_FIELD_STATE 사용하여 필드를 숨기거나 표시합니다.

요구 사항