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

Article
03/04/2024

Associe les informations d’identification et les certificats de l’utilisateur à un ID de connexion ; contient également des éléments de sécurité et d’interface utilisateur supplémentaires.

Syntaxe

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
);

Paramètres

[in] bstrWorkspaceId

Chaîne qui contient l’ID de connexion.

[in] bstrWorkspaceFriendlyName

Nom convivial de l’espace de travail à afficher dans l’interface utilisateur.

[in] bstrRedirectorName

Chaîne contenant le nom du redirecteur.

[in] bstrUserName

Chaîne qui contient un nom d’utilisateur.

[in] bstrPassword

Chaîne qui contient un mot de passe.

[in] bstrAppContainer

Chaîne contenant le conteneur d’application pour l’espace de travail.

[in] bstrWorkspaceParams

Chaîne qui contient un ou plusieurs hachages SHA-1 (Secure Hash Algorithm 1) de certificats de signature à associer à l’ID de connexion spécifié. Les valeurs de hachage doivent être au format de chaîne hexadécimale et délimitées par des points-virgules.

[in] lTimeout

Période, en minutes, après laquelle les informations d’identification sont supprimées.

[in] lFlags

Indicateur qui spécifie les propriétés des informations d’identification de l’utilisateur. Il peut s’agir d’un or au niveau du bit des valeurs suivantes.

WKS_FLAG_CLEAR_CREDS_ON_LAST_RESOURCE (1 (0x1))

Supprimez les informations d’identification dès que la dernière application RemoteApp est fermée.

WKS_FLAG_PASSWORD_ENCRYPTED (2 (0x2))

Le mot de passe est chiffré.

WKS_FLAG_CREDS_AUTHENTICATED (4 (0x4))

Les informations d’identification de l’utilisateur sont vérifiées. Si cet indicateur n’est pas défini, vous devez appeler la méthode OnAuthenticated avant d’utiliser les informations d’identification.

Valeur retournée

Si la méthode réussit, elle retourne S_OK. Sinon, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles incluent, sans s’y limiter, celles de la liste suivante.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	workspaceruntime.h

Voir aussi

IWorkspaceScriptable2

IWorkspaceScriptable3

Partager via