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
유형 라이브러리	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_IMsRdpClient 92b4a539-7115-4b7c-a5a9-e5d9efc2780a로 정의됩니다.