Compartilhar via


Método IWorkspace::StartRemoteApplication (workspaceruntime.h)

Inicia um programa RemoteApp.

Sintaxe

HRESULT StartRemoteApplication(
  [in] BSTR      bstrWorkspaceId,
  [in] SAFEARRAY *psaParams
);

Parâmetros

[in] bstrWorkspaceId

Uma cadeia de caracteres que contém a ID da conexão na qual iniciar o aplicativo.

[in] psaParams

Um ponteiro para uma matriz de valores BSTR que contém parâmetros a serem passados para o runtime do workspace.

Para conexões RDP, esse parâmetro contém duas cadeias de caracteres:

  • Arquivo RDP serializado
  • Parâmetros de linha de comando para o cliente de Conexão de Área de Trabalho Remota

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Chamar o método StartRemoteApplication pode resultar em uma nova conexão.

Quando um cliente personalizado chama o método StartRemoteApplication , o runtime do workspace verifica se o arquivo RDP está assinado corretamente. Se a assinatura do arquivo RDP não for válida, o usuário será solicitado a fornecer novas credenciais para validar o arquivo.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7
Servidor mínimo com suporte Windows Server 2008 R2
Plataforma de Destino Windows
Cabeçalho workspaceruntime.h

Confira também

IWorkspace

IWorkspace2

IWorkspace3