ICredentialProviderUser::GetStringValue 메서드(credentialprovider.h)

입력 값에 따라 ICredentialProviderUser 개체에서 문자열 속성을 검색합니다.

구문

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *stringValue
);

[in] key

검색할 속성을 지정하는 다음 값 중 하나입니다.

REFPROPERTYKEY	Description	적용 대상...
PKEY_Identity_DisplayName	친숙한 사용자 이름입니다.	로그온 UI 및 자격 증명 UI
PKEY_Identity_LogonStatusString	사용자의 로그온 상태 나타내는 지역화된 문자열입니다.	로그온 UI만
PKEY_Identity_PrimarySid	사용자의 SID입니다.	로그온 UI 및 자격 증명 UI
PKEY_Identity_ProviderID	사용자의 공급자 ID입니다.	로그온 UI 및 자격 증명 UI
PKEY_Identity_QualifiedUserName	인증 버퍼를 압축하는 데 사용되는 이름입니다.	로그온 UI 및 자격 증명 UI
PKEY_Identity_UserName	사용자 이름입니다.	로그온 UI 및 자격 증명 UI

[out] stringValue

이 메서드가 성공적으로 반환될 때 요청된 문자열을 수신하는 버퍼에 대한 포인터의 주소입니다.

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

이러한 각 값은 ICredentialProviderUser::GetValue를 통해 PROPVARIANT로 검색할 수도 있습니다.

다음 사용자가 있는 시나리오를 고려합니다.

이 시나리오에서 다음 표에서는 각 키 값에 대한 몇 가지 샘플 데이터를 제공합니다.

REFPROPERTYKEY	도메인 사용자	로컬 사용자	Microsoft 계정
PKEY_Identity_DisplayName	"리사 앤드류스"	"리사 앤드류스"	"리사 앤드류스"
PKEY_Identity_LogonStatusString	"로그인"	"잠김"	"lisa-pc에서 원격으로 로그인"
PKEY_Identity_PrimarySid	"{S-1-5-21-2279990834-2601404236-735077814-1001}"	"{S-1-5-21-2279990834-2601404236-735077814-1001}"	"{S-1-5-21-2279990834-2601404236-735077814-1001}"
PKEY_Identity_ProviderID	"{A198529B-730F-4089-B646-A12557F5665E}"	"{A198529B-730F-4089-B646-A12557F5665E}"	미리 정의되지 않음
PKEY_Identity_QualifiedUserName	"contoso\lisa"	"lisa-pc\lisa"	"<계정 공급자 이름>\lisa@contoso.com"
PKEY_Identity_UserName	"contoso\lisa"	"lisa"	"lisa@contoso.com"