WSManCreateShellEx, fonction (wsman.h)

Crée un objet shell en utilisant la même fonctionnalité que la fonction WSManCreateShell , avec l’ajout d’un ID d’interpréteur de commandes spécifié par le client. Le handle de l’interpréteur de commandes retourné identifie un objet qui définit le contexte dans lequel les commandes peuvent être exécutées. Le contexte est défini par les variables d’environnement, les flux d’entrée et de sortie et le répertoire de travail. Le contexte peut affecter directement le comportement d’une commande. Un contexte d’interpréteur de commandes est créé sur l’ordinateur distant spécifié par le paramètre de connexion et authentifié à l’aide du paramètre d’informations d’identification.

Syntaxe

void WSManCreateShellEx(
  [in, out]      WSMAN_SESSION_HANDLE     session,
                 DWORD                    flags,
  [in]           PCWSTR                   resourceUri,
  [in]           PCWSTR                   shellId,
  [in, optional] WSMAN_SHELL_STARTUP_INFO *startupInfo,
  [in, optional] WSMAN_OPTION_SET         *options,
  [in, optional] WSMAN_DATA               *createXml,
  [in]           WSMAN_SHELL_ASYNC        *async,
  [out]          WSMAN_SHELL_HANDLE       *shell
);

Paramètres

[in, out] session

Spécifie le handle de session retourné par un appel WSManCreateSession . Ce paramètre ne peut pas être NULL.

flags

Réservé pour un usage futur. Doit être égal à 0.

[in] resourceUri

Définit le type d’interpréteur de commandes à créer. Le type d’interpréteur de commandes est défini par un URI unique. L’objet shell réel retourné par l’appel dépend de l’URI spécifié. Ce paramètre ne peut pas être NULL. Pour créer un interpréteur de commandes Windows cmd.exe, utilisez l’URI de ressource WSMAN_CMDSHELL_URI .

[in] shellId

ShellID spécifié par le client.

[in, optional] startupInfo

Pointeur vers une structure WSMAN_SHELL_STARTUP_INFO qui spécifie les flux d’entrée et de sortie, le répertoire de travail, le délai d’inactivité et les options de l’interpréteur de commandes. Si ce paramètre a la valeur NULL, les valeurs par défaut sont utilisées.

[in, optional] options

Pointeur vers une structure WSMAN_OPTION_SET qui spécifie un ensemble d’options pour l’interpréteur de commandes.

[in, optional] createXml

Pointeur vers une structure WSMAN_DATA qui définit un contexte ouvert pour l’interpréteur de commandes. Le contenu doit être une chaîne XML valide. Ce paramètre peut être NULL.

[in] async

Définit une structure asynchrone. La structure asynchrone contient un contexte utilisateur facultatif et une fonction de rappel obligatoire. Pour plus d’informations, consultez la structure WSMAN_SHELL_ASYNC. Ce paramètre ne peut pas être NULL et doit être fermé en appelant la méthode WSManCloseShell .

[out] shell

Définit un handle d’interpréteur de commandes qui identifie de façon unique l’objet shell. Le handle de ressource est utilisé pour suivre le point de terminaison client pour l’interpréteur de commandes et est utilisé par d’autres méthodes WinRM pour interagir avec l’objet shell. L’objet shell doit être supprimé en appelant la méthode WSManCloseShell . Ce paramètre ne peut pas être NULL.

Valeur de retour

None

Spécifications

Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Windows
En-tête	wsman.h
Bibliothèque	WsmSvc.lib
DLL	WsmSvc.dll