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 사용하여 필드를 숨기거나 표시합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | credentialprovider.h |