RemoteApp 및 데스크톱 연결 제어판을 사용하여 클라이언트의 원격 세션을 조정합니다.
참고
RemoteApp 및 데스크톱 연결 제어판이 더 이상 활성 개발 중이 아닙니다. 이후 버전의 Windows에서는 변경되거나 사용할 수 없습니다. 이 API의 사용은 권장되지 않습니다.
구문
HRESULT StartWorkspaceExtension(
[in] VARIANT_BOOL isWebHosted,
[in] BSTR workspaceId,
[in] BYTE *publisherThumbPrint,
[in] UINT publisherThumbPrintLength
);
매개 변수
isWebHosted
웹 사이트에서 연결이 호스트되는지 여부를 나타내는 값입니다.
workspaceId
RemoteApp 및 데스크톱 연결 제어판에 있는 연결의 ID를 포함하는 문자열입니다.
publisherThumbPrint
iWorkspaceScriptable3::StartWorkspaceEx2에 bstrWorkspaceParams로 전달할 이진 형식의 지문을 나타내는 바이트 배열입니다. 설명 부분을 참조하세요.
publisherThumbPrintLength
publisherThumbPrint가 가리키는 바이트 수입니다.
반환 값
성공하면 S_OK 반환합니다.
설명
이 함수는 다음 시나리오를 처리합니다.
- 원격 세션과 연결 시:
- 사용자에게 자격 증명을 묻는 메시지를 표시한 후 IWorkspaceScriptable3::StartWorkspaceEx2를 통해 RemoteApp 및 데스크톱 연결 제어판의 연결에 연결합니다.
- IWorkspaceRegistration2::AddResourceEx를 통해 원격 세션이 있는지 RemoteApp 및 데스크톱 연결 제어판에 알릴 수 있습니다.
- 원격 세션에서 연결이 끊어지면 다음을 수행합니다.
- IWorkspaceScriptable2::ResourceDismissed를 통해 원격 세션이 해제되었음을 사용자에게 경고합니다.
- IWorkspaceRegistration2::RemoveResourceEx를 통해 RemoteApp 및 데스크톱 연결 제어판에 연결 끊김을 알릴 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 11 버전 23H2 |
| 유형 라이브러리 | MsTscAx.dll |
| DLL | MsTscAx.dll |
| IID | IID_IMsRdpClientNonScriptable8 B2B3FA47-3F11-4148-AD24-DFF8684A16D0 정의됩니다. |