Función WSManCreateShell (wsman.h)

Crea un objeto de shell. 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 WSManCreateShell(
  [in, out]      WSMAN_SESSION_HANDLE     session,
                 DWORD                    flags,
  [in]           PCWSTR                   resourceUri,
  [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 cero.

[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 de WSMAN_CMDSHELL_URI .

[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 de 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 7
Servidor mínimo compatible	Windows Server 2008 R2
Plataforma de destino	Windows
Encabezado	wsman.h
Library	WsmSvc.lib
Archivo DLL	WsmSvc.dll
Redistribuible	Windows Management Framework en Windows Server 2008 con SP2 y Windows Vista con SP2