ISCrdEnr::getUserName 메서드

getUserName 메서드는 인증서 등록을 대신하여 사용자의 이름을 검색합니다.

이 메서드를 호출하기 전에 ISCrdEnr::selectUserName 또는 ISCrdEnr::setUserName 호출에서 사용자 이름을 지정해야 합니다.

구문

HRESULT getUserName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrUserName
);


SCrdEnr.getUserName( _
  ByVal dwFlags, _
  ByRef pbstrUserName _
)

dwFlags [in]

이 값은 0, SCARD_ENROLL_UPN_NAME 또는 SCARD_ENROLL_SAM_COMPATIBLE_NAME 중 하나여야 합니다.

이 값이 SCARD_ENROLL_UPN_NAME 경우 getUserName 은 "someone@example.com"와 같은 사용자의 UPN(유니버설 보안 주체 이름)을 반환합니다.

이 값이 SCARD_ENROLL_SAM_COMPATIBLE_NAME 경우 메서드는 "DOMAIN\USER" 형식으로 사용자의 SAM(보안 액세스 관리자) 이름을 반환합니다.

이 값이 0이면 메서드가 있는 경우 사용자의 UPN 이름을 반환합니다. 사용자에게 UPN 이름이 없는 경우 메서드는 사용자의 SAM 이름을 반환합니다.

pbstrUserName [out]

사용자의 이름을 반환하는 문자열에 대한 포인터입니다.

메서드가 성공하면 메서드는 S_OK 반환합니다.

메서드가 실패하면 오류를 나타내는 HRESULT 값이 반환됩니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

사용자의 이름을 나타내는 문자열입니다.

ISCrdEnr::setUserName 또는 ISCrdEnr::selectUserName을 호출하여 스마트 카드 발급되는 사용자의 이름을 지정할 수 있습니다. 사용자 이름을 지정한 후에는 getUserName을 호출하여 해당 값을 검색할 수 있습니다.

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
DLL	Scrdenrl.dll
IID	IID_ISCrdEnr 753988a1-1357-436d-9cf5-f089bdd67d64로 정의됩니다.