Método IWorkspaceScriptable::StartWorkspace (workspaceruntime.h)

Artículo
03/04/2024

Asocia las credenciales de usuario y los certificados a un identificador de conexión.

Sintaxis

HRESULT StartWorkspace(
  [in] BSTR bstrWorkspaceId,
  [in] BSTR bstrUserName,
  [in] BSTR bstrPassword,
  [in] BSTR bstrWorkspaceParams,
  [in] LONG lTimeout,
  [in] LONG lFlags
);

Parámetros

[in] bstrWorkspaceId

Cadena que contiene el identificador de conexión.

[in] bstrUserName

Cadena que contiene un nombre de usuario.

[in] bstrPassword

Cadena que contiene una contraseña.

[in] bstrWorkspaceParams

Cadena que contiene uno o varios hashes de algoritmo hash seguro 1 (SHA-1) de certificados de firma para asociar con el identificador de conexión especificado. Los valores hash deben estar en formato de cadena hexadecimal y delimitados por punto y coma.

[in] lTimeout

Período de tiempo, en minutos, después del cual se eliminan las credenciales.

[in] lFlags

Marca que especifica las propiedades de las credenciales de usuario. Puede ser un OR bit a bit de los valores siguientes.

WKS_FLAG_CLEAR_CREDS_ON_LAST_RESOURCE (1 (0x1))

Elimine las credenciales en cuanto se cierre la última aplicación RemoteApp.

WKS_FLAG_PASSWORD_ENCRYPTED (2 (0x2))

La contraseña está cifrada.

WKS_FLAG_CREDS_AUTHENTICATED (4 (0x4))

Se comprueban las credenciales de usuario. Si no se establece esta marca, debe llamar al método OnAuthenticated antes de usar las credenciales.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen, entre otros, los de la lista siguiente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Windows
Encabezado	workspaceruntime.h