Partilhar via

Método IMsRdpClientNonScriptable8::StartWorkspaceExtension

  • Artigo

Coordena a sessão remota do cliente com o painel de controle RemoteApp e Conexões de Área de Trabalho.

Observação

O painel de controle Conexões de Área de Trabalho e RemoteApp não está mais em desenvolvimento ativo. Ele pode estar alterado ou indisponível em versões futuras do Windows. O uso dessa API é desencorajado.

Sintaxe

HRESULT StartWorkspaceExtension( 
    [in] VARIANT_BOOL isWebHosted,
    [in] BSTR workspaceId,
    [in] BYTE *publisherThumbPrint,
    [in] UINT publisherThumbPrintLength
);

Parâmetros

isWebHosted

Um valor que indica se a conexão está hospedada de um site.

workspaceId

Uma cadeia de caracteres que contém a ID de uma conexão no painel de controle RemoteApp e Conexões de Área de Trabalho.

publisherThumbPrint

Uma matriz de bytes que representa a impressão digital no formato binário a ser passada para IWorkspaceScriptable3::StartWorkspaceEx2 como bstrWorkspaceParams. Consulte Observações.

publisherThumbPrintLength

O número de bytes apontados pelo publisherThumbPrint.

Retornar valor

Retorne S_OK se tiver êxito.

Comentários

Essa função lida com os seguintes cenários:

  • Após a conexão com a sessão remota:
    • Depois de solicitar credenciais ao usuário, ele as associa a uma conexão no painel de controle RemoteApp e Conexões de Área de Trabalho por meio de IWorkspaceScriptable3::StartWorkspaceEx2
    • Ele notifica o painel de controle Conexões de Área de Trabalho e RemoteApp da existência da sessão remota por meio de IWorkspaceRegistration2::AddResourceEx.
  • Após a desconexão da sessão remota:

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 11 versão 23H2
Biblioteca de tipos MsTscAx.dll
DLL MsTscAx.dll
IID IID_IMsRdpClientNonScriptable8 é definido como B2B3FA47-3F11-4148-AD24-DFF8684A16D0

Confira também

IMsRdpClientNonScriptable8