Método IWorkspaceScriptable2::StartWorkspaceEx (workspaceruntime.h)

Artigo
03/13/2024

Associa credenciais de usuário e certificados a uma ID de conexão; também contém elementos adicionais de segurança e interface do usuário.

Sintaxe

HRESULT StartWorkspaceEx(
  [in] BSTR bstrWorkspaceId,
  [in] BSTR bstrWorkspaceFriendlyName,
  [in] BSTR bstrRedirectorName,
  [in] BSTR bstrUserName,
  [in] BSTR bstrPassword,
  [in] BSTR bstrAppContainer,
  [in] BSTR bstrWorkspaceParams,
  [in] LONG lTimeout,
  [in] LONG lFlags
);

Parâmetros

[in] bstrWorkspaceId

Uma cadeia de caracteres que contém a ID de conexão.

[in] bstrWorkspaceFriendlyName

O nome amigável do workspace a ser exibido na interface do usuário.

[in] bstrRedirectorName

Cadeia de caracteres que contém o nome do redirecionador.

[in] bstrUserName

Uma cadeia de caracteres que contém um nome de usuário.

[in] bstrPassword

Uma cadeia de caracteres que contém uma senha.

[in] bstrAppContainer

Uma cadeia de caracteres que contém o contêiner do aplicativo para o workspace.

[in] bstrWorkspaceParams

Uma cadeia de caracteres que contém um ou mais hashes SHA-1 (Secure Hash Algorithm 1) de certificados de assinatura a serem associados à ID de conexão especificada. Os valores de hash devem estar no formato de cadeia de caracteres hexadecimal e delimitados por ponto e vírgula.

[in] lTimeout

O período de tempo, em minutos, após o qual as credenciais são excluídas.

[in] lFlags

Um sinalizador que especifica as propriedades das credenciais do usuário. Isso pode ser um OR bit a bit dos valores a seguir.

WKS_FLAG_CLEAR_CREDS_ON_LAST_RESOURCE (1 (0x1))

Exclua as credenciais assim que o último aplicativo RemoteApp for fechado.

WKS_FLAG_PASSWORD_ENCRYPTED (2 (0x2))

A senha é criptografada.

WKS_FLAG_CREDS_AUTHENTICATED (4 (0x4))

As credenciais do usuário são verificadas. Se esse sinalizador não estiver definido, você deverá chamar o método OnAuthenticated antes de usar as credenciais.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um valor HRESULT que indica o erro. Os valores possíveis incluem, mas não se limitam, aqueles na lista a seguir.

Requisitos

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

Confira também

IWorkspaceScriptable2

IWorkspaceScriptable3

Compartilhar via