IWRdsProtocolConnection2::GetSerializedUserCredential 메서드(wtsprotocol.h)

직렬화된 사용자 자격 증명을 반환합니다.

Syntax

HRESULT GetSerializedUserCredential(
    [out] WRDS_SERIALIZED_USER_CREDENTIAL** userCredential);

Syntax

HRESULT GetSerializedUserCredential(
  [out] WRDS_SERIALIZED_USER_CREDENTIAL **userCredential
);

매개 변수

[out] userCredential

함수가 성공하면 serialize된 자격 증명을 포함하는 WTS_SERIALIZED_USER_CREDENTIAL 인스턴스에 대한 포인터를 받습니다. 할당된 메모리를 해제하기 위해 원격 데스크톱 서비스 서비스는 WTSFreeMemoryEx 함수를 호출하고 WTSTypeClass 매개 변수에 대해 WTSTypeSerializedUserCredential을 전달합니다. 프로토콜 구현은 WTSCloudAuthConvertAssertionToSerializedUserCredential (권장)을 사용하여 얻은 자격 증명의 소유권을 이전할 수 있으며, 그 후에는 더 이상 자격 증명을 사용하지 않아야 합니다. 또는 프로토콜 구현에서 WTSCloudAuthDuplicateSerializedUserCredential*를 사용하여 WTSCloudAuthConvertAssertionToSerializedUserCredential에서 가져온 직렬화된 자격 증명을 복제할 수 있습니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다. 함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 Common HRESULT 값을 참조하세요.

비고

프로토콜이 이 메서드와 **IWRdsProtocolConnection::GetUserCredentials에서 HRESULT 오류 코드를 반환하는 경우 WinLogon은 자격 증명을 요청하는 로그온 화면을 표시합니다. 프로토콜이 S_OK 반환하는 경우 자격 증명이 WinLogon에 전달되어 사용자를 로그온합니다.

요구 사항