다음을 통해 공유


IMsRdpClientNonScriptable8::StartWorkspaceExtension 메서드

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::StartWorkspaceEx2bstrWorkspaceParams로 전달할 이진 형식의 지문을 나타내는 바이트 배열입니다. 설명 부분을 참조하세요.

publisherThumbPrintLength

publisherThumbPrint가 가리키는 바이트 수입니다.

반환 값

성공하면 S_OK 반환합니다.

설명

이 함수는 다음 시나리오를 처리합니다.

  • 원격 세션과 연결 시:
    • 사용자에게 자격 증명을 묻는 메시지를 표시한 후 IWorkspaceScriptable3::StartWorkspaceEx2를 통해 RemoteApp 및 데스크톱 연결 제어판의 연결에 연결합니다.
    • IWorkspaceRegistration2::AddResourceEx를 통해 원격 세션이 있는지 RemoteApp 및 데스크톱 연결 제어판에 알릴 수 있습니다.
  • 원격 세션에서 연결이 끊어지면 다음을 수행합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 11 버전 23H2
유형 라이브러리 MsTscAx.dll
DLL MsTscAx.dll
IID IID_IMsRdpClientNonScriptable8 B2B3FA47-3F11-4148-AD24-DFF8684A16D0 정의됩니다.

참고 항목

IMsRdpClientNonScriptable8