IMsRdpClient::RequestClose 메서드
원격 데스크톱 ActiveX 컨트롤의 정상적인 종료를 요청합니다. 정상적인 종료에는 사용자의 원격 데스크톱 서비스 세션 종료가 포함될 수 있지만 RD 세션 호스트(원격 데스크톱 세션 호스트) 서버는 종료되지 않습니다.
구문
HRESULT RequestClose(
[out] ControlCloseStatus *pCloseStatus
);
매개 변수
-
pCloseStatus [out]
-
애플리케이션이 컨트롤을 즉시 닫을 수 있는지 여부를 나타내는 ControlCloseStatus 열거형의 값입니다. 다음은 가능한 값 목록입니다.
-
controlCloseCanProceed (0x0000)
-
컨테이너 애플리케이션에서 컨트롤을 즉시 닫을 수 있습니다. 이 값은 연결이 이미 종료되었음을 나타낼 수도 있습니다.
-
controlCloseWaitForEvents (0x0001)
-
컨테이너 애플리케이션은 컨트롤을 즉시 닫아서는 안 됩니다. 애플리케이션은 닫기 전에 다음 설명 섹션에 설명된 이벤트 중 하나가 발생할 때까지 기다려야 합니다.
반환 값
성공하면 S_OK 반환합니다.
설명
pCloseStatus 매개 변수가 controlCloseWaitForEvents와 같으면 애플리케이션이 컨트롤을 닫기 전에 다음 이벤트 중 하나가 발생할 때까지 기다려야 합니다.
- IMsTscAxEvents::OnDisconnected. 사용자가 원격 데스크톱 서비스 세션에 로그온하지 않은 경우 애플리케이션은 DestroyWindow 함수를 호출하여 모든 창을 삭제한 다음 컨트롤을 닫을 수 있습니다.
- IMsTscAxEvents::OnConfirmClose. 사용자가 원격 데스크톱 서비스 세션에 로그온하는 경우 컨트롤은 OnConfirmClose 이벤트를 발생합니다. 이 이벤트를 사용하면 애플리케이션이 사용자에게 연결을 닫을지 여부를 묻는 메시지를 표시할 수 있습니다. 사용자가 프롬프트에 예라고 회신하면 컨테이너 애플리케이션에서 DestroyWindow 를 호출하여 모든 창을 삭제하고 컨트롤을 닫을 수 있습니다.
RequestClose 를 사용하면 컨테이너 애플리케이션이 사용자에게 연결을 닫을지 여부를 묻는 메시지를 표시할 수 있습니다. 자세한 내용은 IMsTscAxEvents::OnConfirmClose를 참조하세요.
원격 데스크톱 웹 연결에 대한 자세한 내용은 원격 데스크톱 웹 연결에 대한 요구 사항을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 유형 라이브러리 |
|
| DLL |
|
| IID |
IID_IMsRdpClient 92b4a539-7115-4b7c-a5a9-e5d9efc2780a로 정의됩니다. |