Función WSManCreateShellEx (wsman.h)

Crea un objeto de shell mediante la misma funcionalidad que la función WSManCreateShell , con la adición de un identificador de shell especificado por el cliente. El identificador de shell devuelto identifica un objeto que define el contexto en el que se pueden ejecutar los comandos. El contexto se define mediante las variables de entorno, los flujos de entrada y salida y el directorio de trabajo. El contexto puede afectar directamente al comportamiento de un comando. Se crea un contexto de shell en el equipo remoto especificado por el parámetro de conexión y se autentica mediante el parámetro credentials.

Sintaxis

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

Parámetros

[in, out] session

Especifica el identificador de sesión devuelto por una llamada WSManCreateSession . Este parámetro no puede ser NULL.

flags

Reservado para uso futuro. Debe ser 0.

[in] resourceUri

Define el tipo de shell que se va a crear. El tipo de shell se define mediante un URI único. El objeto de shell real devuelto por la llamada depende del URI especificado. Este parámetro no puede ser NULL. Para crear un shell de Windows cmd.exe, use el URI del recurso WSMAN_CMDSHELL_URI .

[in] shellId

ShellID especificado por el cliente.

[in, optional] startupInfo

Puntero a una estructura de WSMAN_SHELL_STARTUP_INFO que especifica los flujos de entrada y salida, el directorio de trabajo, el tiempo de espera de inactividad y las opciones del shell. Si este parámetro es NULL, se usarán los valores predeterminados.

[in, optional] options

Puntero a una estructura WSMAN_OPTION_SET que especifica un conjunto de opciones para el shell.

[in, optional] createXml

Puntero a una estructura WSMAN_DATA que define un contexto abierto para el shell. El contenido debe ser una cadena XML válida. Este parámetro puede ser NULL.

[in] async

Define una estructura asincrónica. La estructura asincrónica contiene un contexto de usuario opcional y una función de devolución de llamada obligatoria. Consulte la estructura WSMAN_SHELL_ASYNC para obtener más información. Este parámetro no puede ser NULL y debe cerrarse llamando al método WSManCloseShell .

[out] shell

Define un identificador de shell que identifica de forma única el objeto de shell. El identificador de recursos se usa para realizar un seguimiento del punto de conexión de cliente del shell y lo usan otros métodos de WinRM para interactuar con el objeto de shell. El objeto de shell debe eliminarse llamando al método WSManCloseShell . Este parámetro no puede ser NULL.

Valor devuelto

None

Requisitos

Cliente mínimo compatible	Windows 8
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	wsman.h
Library	WsmSvc.lib
Archivo DLL	WsmSvc.dll