다음을 통해 공유

IRemoteDesktopClientSettings::SetRdpProperty 메서드(rdpappcontainerclient.h)

  • 아티클

명명된 단일 RDP 속성의 값을 설정합니다.

구문

HRESULT SetRdpProperty(
  [in] BSTR    propertyName,
  [in] VARIANT value
);

매개 변수

[in] propertyName

속성의 이름을 지정하는 문자열입니다.

참고 이러한 문자열 값은 대/소문자를 구분하지 않습니다.
 

가능한 값은 입니다.

"관리 세션"(부울)

세션이 관리 세션인지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

세션이 관리 세션이 아닙니다.

True

세션은 관리 세션입니다.

"글꼴 다듬기 허용"(부울)

원격 세션에서 글꼴 다듬기가 허용되는지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

글꼴 다듬기는 허용되지 않습니다.

True

글꼴 다듬기는 허용됩니다.

"대체 전체 주소"(문자열)

연결할 원격 컴퓨터의 대체 이름 또는 IP 주소를 지정합니다.

"audiocapturemode"(부울)

오디오 입력 캡처 모드를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

오디오 입력을 캡처하지 마세요.

True

오디오 입력을 캡처합니다.

"audiomode"(숫자)

소리가 재생되는 위치를 지정합니다. 다음 값 중 하나일 수 있습니다.

0

클라이언트 컴퓨터에서 소리를 재생합니다.

1

호스트 컴퓨터에서 소리를 재생합니다.

2

소리를 재생하지 마십시오.

"인증 수준"(숫자)

원격 세션의 인증 수준을 지정합니다. 다음 값 중 하나일 수 있습니다.

0

없음

1

인증 필요.

2

인증 협상 가능.

3

인증이 지정되지 않았습니다.

"연결 형식"(숫자)

연결 형식을 지정합니다. 다음 값 중 하나일 수 있습니다.

1

모뎀

2

저속 광대역

3

위성

4

고속 광대역

5

WAN

6

LAN

7

자동 검색

쿠키 기반 인증 서버의 주소를 지정합니다.

"desktopheight"(숫자)

가상 데스크톱의 높이를 픽셀 단위로 지정합니다.

"desktopwidth"(숫자)

가상 데스크톱의 너비를 픽셀 단위로 지정합니다.

"전체 창 끌기 사용 안 함"(부울)

끌어서 끌 때 창 내용을 표시하지 않도록 설정할지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

사용

True

사용 안 함

"메뉴 anims 사용 안 함"(부울)

메뉴 애니메이션을 표시하지 않도록 설정할지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

사용

True

사용 안 함

"테마 사용 안 함"(부울)

테마를 사용하지 않도록 설정할지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

사용

True

사용 안 함

"배경 화면 사용 안 함"(부울)

배경 화면 표시 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

배경 화면이 표시됩니다.

True

배경 화면이 표시되지 않습니다.

"domain"(String)

원격 세션에 연결하는 데 사용되는 도메인을 지정합니다.

"enablecredsspsupport"(부울)

원격 세션에 CredSSP 기반 인증을 사용할지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

CredSSP 기반 인증을 사용하지 마세요.

True

CredSSP 기반 인증을 사용합니다.

"전체 주소"(문자열)

연결된 컴퓨터의 주소를 지정합니다.

"gatewaycredentialssource"(숫자)

원격 데스크톱 게이트웨이에 대한 자격 증명의 원본을 지정합니다. 다음 값 중 하나일 수 있습니다.

0

사용자에게 자격 증명을 묻는 메시지를 표시하고 NTLM 인증을 사용합니다.

1

자격 증명에 스마트 카드 사용합니다.

2

현재 로그온한 사용자의 자격 증명을 사용합니다.

3

사용자에게 자격 증명을 묻는 메시지를 표시하고 기본 인증을 사용합니다.

4

사용자는 로그온 시 자격 증명 원본을 선택합니다.

5

쿠키 기반 인증을 사용합니다.

"gatewayhostname"(문자열)

원격 데스크톱 게이트웨이 서버 이름을 지정합니다.

"gatewayprofileusagemethod"(숫자)

원격 데스크톱 게이트웨이 프로필 사용을 지정합니다. 다음 값 중 하나일 수 있습니다.

0

게이트웨이 프로필 설정(있는 경우)을 사용합니다.

1

게이트웨이 프로필이 있는 경우에도 명시적 게이트웨이 설정을 사용합니다.

"gatewayusagemethod"(Number)

원격 데스크톱 게이트웨이 사용을 지정합니다. 다음 값 중 하나일 수 있습니다.

0

원격 데스크톱 게이트웨이 서버를 사용하지 마세요. 로컬 주소 검사 RD 게이트웨이 서버 바이패스 상자가 지워집니다.

1

"gatewayhostname" 속성으로 지정된 원격 데스크톱 게이트웨이를 사용합니다.

2

원격 데스크톱 게이트웨이 서버 설정을 자동으로 검색합니다.

3

기본 설정 원격 데스크톱 게이트웨이 사용 설정을 사용합니다.

4

원격 데스크톱 게이트웨이 서버를 사용하지 마세요. 로컬 주소 검사 RD 게이트웨이 서버 바이패스 상자가 선택되어 있습니다.

"고해상도 마우스"(부울)

마우스 입력의 해상도 모드를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

마우스 입력이 병합됩니다. 마우스 데이터는 하위 샘플링되고 기본 샘플링 속도에 따라 전송됩니다.

True

마우스 입력은 병합되지 않습니다. 마우스 데이터는 전체 해상도로 전송됩니다.

"loadbalanceinfo"(문자열)

클라이언트 컴퓨터에 가장 적합한 서버를 선택하는 데 사용되는 부하 분산 쿠키를 포함합니다.

"로그인 웹 페이지 주소"(문자열)

로그인 웹 페이지의 주소를 지정합니다.

"사전 인증 서버 주소"(문자열)

사전 인증 서버의 주소를 지정합니다.

"자격 증명 프롬프트"(부울)

사용자에게 자격 증명을 묻는 메시지가 표시될지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

사용자에게 자격 증명을 묻는 메시지가 표시되지 않습니다.

True

사용자에게 자격 증명을 묻는 메시지가 표시됩니다.

"promptcredentialonce"(숫자)

원격 데스크톱 게이트웨이에 대한 자격 증명 공유를 사용할 수 있는지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

0

자격 증명 공유를 사용할 수 없습니다.

1

자격 증명 공유를 사용할 수 있습니다.

"redirectclipboard"(부울)

클라이언트의 클립보드가 원격 세션으로 리디렉션되는지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

클립보드가 리디렉션되지 않습니다.

True

클립보드가 리디렉션됩니다.

"redirectprinters"(부울)

클라이언트의 프린터가 원격 세션으로 리디렉션되는지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

프린터가 리디렉션되지 않습니다.

True

프린터가 리디렉션됩니다.

"사전 인증 필요"(번호)

사전 인증이 필요한지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

0

사전 인증은 필요하지 않습니다.

1

사전 인증이 필요합니다.

"support url"(String)

지원 정보를 가져올 URL을 지정합니다.

Boolean

"리디렉션 서버 이름 사용"(부울)

리디렉션 서버가 허용되는지 여부를 지정합니다. 다음 값 중 하나일 수 있습니다.

false

리디렉션 서버는 허용되지 않습니다.

True

리디렉션 서버가 허용됩니다.

"username"(String)

원격 세션에 연결하는 데 사용되는 사용자 이름을 지정합니다.

"WinRTEncryptedPassword"(문자열)

암호화된 암호를 지정합니다. 이 속성을 설정하려면 다음 작업을 수행해야 합니다.

  1. CryptographicBuffer 클래스에서 ConvertStringToBinary 메서드를 사용하여 지우기 텍스트 암호를 이진으로 변환합니다.
  2. 1단계에서 ConvertStringToBinary 메서드에 전달한 인코딩 매개 변수에 해당하는 값을 사용하여 WinRTPasswordEncoding 속성을 설정합니다.
  3. 입력 문자열에 대해 "LOCAL=user"를 전달하여 DataProtectionProvider(String) 메서드를 호출합니다.
  4. ProtectAsync 메서드를 호출하여 암호가 포함된 이진 문자열을 암호화합니다.
  5. EncodeToBase64String 메서드를 사용하여 ProtectAsync 메서드에서 반환된 CryptographicBuffer 개체를 Base64로 인코딩된 값으로 변환합니다.
  6. 5단계에서 가져온 Base64 인코딩 문자열을 사용하여 이 속성(WinRTEncryptedPassword)을 설정합니다.

"WinRTPasswordEncoding"(숫자)

암호화된 암호에 적용할 수 있는 인코딩 유형을 지정합니다. 다음 값 중 하나일 수 있습니다. 기본값은 1입니다. WinRTEncryptedPassword 속성을 설정하기 전에 이 속성을 설정해야 합니다.

0

UTF8

1

UTF16LE

2

UTF16BE

"작업 영역 ID"(문자열)

이 RDP 파일이 일부로 게시된 RemoteApp 및 데스크톱 연결 작업 영역의 식별자를 지정합니다.

[in] value

새 속성 값입니다.

반환 값

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8
지원되는 최소 서버 Windows Server 2012
대상 플랫폼 Windows
헤더 rdpappcontainerclient.h
DLL MsTscAx.dll

추가 정보

IRemoteDesktopClientSettings