Compartir a través de

Función WSManRunShellCommand (wsman.h)

  • Artículo

Inicia la ejecución de un comando dentro de un shell existente y no espera la finalización del comando.

Sintaxis

void WSManRunShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandLine,
  [in, optional] WSMAN_COMMAND_ARG_SET *args,
  [in, optional] WSMAN_OPTION_SET      *options,
  [in]           WSMAN_SHELL_ASYNC     *async,
  [out]          WSMAN_COMMAND_HANDLE  *command
);

Parámetros

[in, out] shell

Especifica el identificador de shell devuelto por la llamada de WSManCreateShell . Este parámetro no puede ser NULL.

flags

Reservado para uso futuro. Debe ser cero.

[in] commandLine

Define una cadena terminada en null necesaria que representa el comando que se va a ejecutar. Normalmente, el comando se especifica sin ningún argumento, que se especifican por separado. Sin embargo, un usuario puede especificar la línea de comandos y todos los argumentos mediante este parámetro. Si se especifican argumentos para el parámetro commandLine , el parámetro args debe ser NULL.

[in, optional] args

Puntero a una estructura de WSMAN_COMMAND_ARG_SET que define una matriz de valores de argumento, que se pasan al comando al crear. Si no se requieren argumentos, este parámetro debe ser NULL.

[in, optional] options

Define un conjunto de opciones para el comando. Estas opciones se pasan al servicio para modificar o refinar la ejecución del comando. Este parámetro puede ser NULL. Para obtener más información sobre las opciones, consulte WSMAN_OPTION_SET.

[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 WSManCloseCommand .

[out] command

Define el objeto de comando asociado a un comando dentro de un shell. Este identificador se devuelve en una llamada correcta y se usa para enviar y recibir datos y para indicar el comando. Este identificador debe cerrarse llamando al método WSManCloseCommand . 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