MsRdpClient 클래스
Microsoft RDP 클라이언트 컨트롤(재배포 가능) - 버전 2
이 클래스는 다음 인터페이스를 구현합니다.
MsRdpClient 에는 다음과 같은 유형의 멤버가 있습니다.
메서드
MsRdpClient 클래스에는 이러한 메서드가 있습니다.
| 메서드 | Description |
|---|---|
| 연결 | 현재 컨트롤에 설정된 속성을 사용하여 연결을 시작합니다. |
| CreateVirtualChannels | 지정된 각 가상 채널 이름에 대한 클라이언트 쪽 가상 채널 개체를 만듭니다. |
| 연결 끊기 | 활성 연결을 끊습니다. |
| GetVirtualChannelOptions | 가상 채널에 대해 설정된 옵션을 검색합니다. |
| NotifyRedirectDeviceChange | 원격 데스크톱 ActiveX 컨트롤의 디바이스 리디렉션 모듈에 시스템에서 디바이스 변경이 발생했음을 알 수 있습니다. 이 메서드는 컨트롤에 WM_DEVICECHANGE 알림을 전달합니다. |
| OnAuthenticationWarningDismissed | ActiveX 컨트롤이 인증 대화 상자를 표시한 후 호출됩니다(예: 인증서 오류 대화 상자). |
| OnAuthenticationWarningDisplayed | ActiveX 컨트롤이 인증 대화 상자를 표시하기 전에 호출됩니다(예: 인증서 오류 대화 상자). |
| OnAutoReconnected | 클라이언트 컨트롤이 원격 세션에 자동으로 다시 연결될 때 호출됩니다. |
| OnAutoReconnecting | 클라이언트가 RD 세션 호스트 서버와 세션을 자동으로 다시 연결하는 프로세스에 있을 때 호출됩니다. |
| OnAutoReconnecting2 | 클라이언트가 RD 세션 호스트 서버와 세션을 자동으로 다시 연결하는 프로세스에 있을 때 호출됩니다. |
| OnChannelReceivedData | 클라이언트가 스크립팅 가능한 가상 채널에서 데이터를 수신할 때 호출됩니다. |
| OnConfirmClose | 클라이언트가 IMsRdpClient::RequestClose 메서드를 호출할 때 호출됩니다. |
| OnConnected | 클라이언트 컨트롤이 RD 세션 호스트 서버와의 연결을 설정하는 중일 때 호출됩니다. |
| OnConnecting |
IMsTscAx::Connect 호출에 대한 응답으로 클라이언트 컨트롤이 서버에 연결을 시작할 때 호출됩니다. |
| OnConnectionBarPullDown | 사용자가 연결 표시줄에서 아래로 끌면 호출됩니다. |
| OnDevicesButtonPressed | 연결 표시줄의 디바이스 단추를 누를 때 호출됩니다. |
| OnDisconnected | RD 세션 호스트 서버에서 클라이언트 컨트롤의 연결이 끊어졌을 때 호출됩니다. |
| OnEnterFullScreenMode | 클라이언트가 전체 화면 모드로 전환되면 호출됩니다. 예를 들어 이 이벤트는 사용자가 전체 화면 모드 바로 가기 키 조합(Ctrl+Alt+BREAK)을 누를 때 호출됩니다. |
| OnFatalError | 클라이언트 컨트롤에 치명적인 오류가 발생할 때 호출됩니다. |
| OnFocusReleased | 릴리스 포커스 키 조합을 누를 때 호출됩니다. 예를 들어 이 이벤트는 사용자가 Ctrl+Alt+왼쪽 화살표 또는 Ctrl+Alt+오른쪽 화살표 키 조합을 누를 때 호출됩니다. |
| OnIdleTimeoutNotification |
IMsRdpClientAdvancedSettings::p ut_MinutesToIdleTimeout 메서드에서 설정한 기간 동안 사용자가 마우스 또는 키보드 입력이 없을 때 호출됩니다. |
| OnLeaveFullScreenMode | 클라이언트가 전체 화면 모드를 떠날 때 호출됩니다. 예를 들어 이 이벤트는 사용자가 전체 화면 모드 바로 가기 키 조합(Ctrl+Alt+BREAK)을 누를 때 호출됩니다. |
| OnLoginComplete | Windows 로그온 대화 상자가 표시된 후 클라이언트 컨트롤이 RD 세션 호스트 서버에 성공적으로 로그온되면 호출됩니다. |
| OnLogonError | 로그온 오류 또는 기타 로그온 이벤트가 발생할 때 호출됩니다. |
| OnMouseInputModeChanged | 마우스 입력 모드가 변경되면 호출됩니다. |
| OnNetworkStatusChanged | 네트워크 상태 변경되면 호출됩니다. |
| OnReceivedTSPublicKey | 클라이언트가 서버에서 공개 키를 검색할 때 연결 시퀀스 중에 호출됩니다. 이 이벤트는 NotifyTSPublicKey 속성이 VARIANT_TRUE 경우에만 호출됩니다. |
| OnRemoteDesktopSizeChange | 클라이언트 컨트롤 작업에 대한 응답으로 원격 데스크톱의 클라이언트 컨트롤 크기가 변경되었음을 나타내기 위해 호출됩니다. |
| OnRemoteProgramDisplayed | RemoteApp 프로그램이 표시될 때 호출됩니다. |
| OnRemoteProgramResult | RemoteApp 프로그램이 클라이언트 컨트롤에 결과를 반환할 때 호출됩니다. |
| OnRemoteWindowDisplayed | RemoteApp 창이 표시될 때 호출됩니다. |
| OnRequestContainerMinimize | 사용자가 연결 표시줄의 최소화 단추를 전체 화면 모드로 누를 때 호출됩니다. 이 이벤트의 발생은 컨테이너 애플리케이션 자체를 최소화하는 요청입니다. |
| OnRequestGoFullScreen | 클라이언트가 전체 화면 모드로 전환을 요청하고 IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen 메서드가 호출되어 ContainerHandledFullScreen 속성을 0이 아닌 값으로 설정할 때 호출됩니다. |
| OnRequestLeaveFullScreen | 클라이언트가 전체 화면 모드를 종료하도록 요청하고 IMsTscAdvancedSettings::p ut_ContainerHandledFullScreen 속성이 0이 아닌 값으로 설정된 경우 호출됩니다. |
| OnServiceMessageReceived | 클라이언트가 시스템 메시지를 받을 때 호출됩니다. |
| OnUserNameAcquired | 컨트롤에서 사용자 이름을 가져올 때 호출됩니다. |
| OnWarning | 클라이언트 컨트롤에 치명적이지 않은 오류 조건이 발생할 때 호출됩니다. |
| RequestClose | 클라이언트 컨트롤의 정상적인 종료를 요청합니다. |
| ResetPassword | 컨트롤의 모든 암호 상태를 다시 설정합니다. |
| SendKeys | 컨트롤에 일련의 키 입력을 보냅니다. 키 입력은 실제 물리적 키의 키보드 데이터인 스캔 코드 형식입니다. |
| SendOnVirtualChannel |
IMsTscAx::CreateVirtualChannels 메서드를 사용하여 이전에 만든 가상 채널을 통해 RD 세션 호스트 서버에 데이터를 보냅니다. |
| SetVirtualChannelOptions | 클라이언트 컨트롤에 대한 가상 채널 옵션을 설정합니다. |
속성
MsRdpClient 클래스에는 이러한 속성이 있습니다.
| 속성 | 액세스 유형 | 설명 |
|---|---|---|
|
AdvancedSettings |
읽기 전용 |
IMsTscAdvancedSettings 인터페이스 포인터입니다. |
|
AdvancedSettings2 |
읽기 전용 |
클라이언트 컨트롤에 대한 고급 설정을 설정하는 데 사용되는 IMsRdpClientAdvancedSettings 인터페이스에 대한 포인터입니다. |
|
BinaryPassword |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
|
BinarySalt |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
|
CipherStrength |
읽기 전용 |
현재 컨트롤의 최대 암호화 강도입니다. |
|
ClearTextPassword |
쓰기 전용 |
일반 텍스트 형식의 원격 데스크톱 ActiveX 컨트롤 암호입니다. |
|
ColorDepth |
읽기/쓰기 |
현재 컨트롤의 색 깊이입니다. |
|
연결됨 |
읽기 전용 |
현재 컨트롤의 연결 상태입니다. |
|
ConnectingText |
읽기/쓰기 |
컨트롤이 연결되는 동안 컨트롤의 가운데에 표시되는 텍스트입니다. |
|
DesktopHeight |
읽기/쓰기 |
초기 원격 데스크톱에서 현재 컨트롤의 높이(픽셀)입니다. |
|
DesktopWidth |
읽기/쓰기 |
초기 원격 데스크톱에서 현재 컨트롤의 너비(픽셀)입니다. |
|
DisconnectedText |
읽기/쓰기 |
연결이 종료되기 전에 컨트롤의 가운데에 표시되는 텍스트입니다. |
|
도메인 |
읽기/쓰기 |
현재 사용자가 로그온하는 도메인입니다. |
|
ExtendedDisconnectReason |
읽기 전용 |
클라이언트 컨트롤의 연결 끊김 이유에 대한 확장된 정보입니다. |
|
FullScreen |
읽기/쓰기 |
컨트롤이 전체 화면 모드인지 여부를 나타냅니다. |
|
FullScreenTitle |
쓰기 전용 |
컨트롤이 전체 화면 모드일 때 표시되는 창 제목입니다. |
|
HorizontalScrollBarVisible |
읽기 전용 |
컨트롤에 가로 스크롤 막대가 표시되었는지 여부를 나타냅니다. |
|
PortablePassword |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
|
PortableSalt |
읽기/쓰기 |
이 속성이 지원되지 않는 경우 |
|
SecuredSettings |
읽기 전용 |
IMsTscSecuredSettings 인터페이스 포인터입니다. |
|
SecuredSettings2 |
읽기 전용 |
클라이언트 컨트롤에 대한 보안 설정을 설정하는 데 사용되는 IMsRdpClientSecuredSettings 인터페이스에 대한 포인터입니다. |
|
SecuredSettingsEnabled |
읽기 전용 |
IMsTscSecuredSettings 인터페이스를 사용할 수 있는지 여부를 나타냅니다. |
|
서버 |
읽기/쓰기 |
현재 컨트롤이 연결된 서버의 이름입니다. |
|
StartConnected |
읽기/쓰기 |
시작 시 컨트롤이 RD 세션 호스트 서버 연결을 즉시 설정할지 여부를 나타냅니다. |
|
사용자 |
읽기/쓰기 |
사용자 이름 로그온 자격 증명입니다. |
|
버전 |
읽기 전용 |
현재 컨트롤의 버전 번호입니다. |
|
VerticalScrollBarVisible |
읽기 전용 |
컨트롤에 세로 스크롤 막대가 표시되는지 여부를 나타냅니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 유형 라이브러리 |
|
| DLL |
|
| CLSID |
CLSID_MsRdpClient 791fa017-2de3-492e-acc5-53c67a2b94d0으로 정의됩니다. |