Função WSManRunShellCommand (wsman.h)

Inicia a execução de um comando em um shell existente e não aguarda a conclusão do comando.

Sintaxe

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 o identificador de shell retornado pela chamada WSManCreateShell . Esse parâmetro não pode ser NULL.

flags

Reservado para uso futuro. Deve ser zero.

[in] commandLine

Define uma cadeia de caracteres terminada em nulo necessária que representa o comando a ser executado. Normalmente, o comando é especificado sem argumentos, que são especificados separadamente. No entanto, um usuário pode especificar a linha de comando e todos os argumentos usando esse parâmetro. Se os argumentos forem especificados para o parâmetro commandLine , o parâmetro args deverá ser NULL.

[in, optional] args

Um ponteiro para uma estrutura WSMAN_COMMAND_ARG_SET que define uma matriz de valores de argumento, que são passados para o comando na criação. Se nenhum argumento for necessário, esse parâmetro deverá ser NULL.

[in, optional] options

Define um conjunto de opções para o comando . Essas opções são passadas para o serviço para modificar ou refinar a execução do comando. Este parâmetro pode ser NULL. Para obter mais informações sobre as opções, consulte WSMAN_OPTION_SET.

[in] async

Define uma estrutura assíncrona. A estrutura assíncrona contém um contexto de usuário opcional e uma função de retorno de chamada obrigatória. Consulte a estrutura WSMAN_SHELL_ASYNC para obter mais informações. Esse parâmetro não pode ser NULL e deve ser fechado chamando o método WSManCloseCommand .

[out] command

Define o objeto de comando associado a um comando dentro de um shell. Esse identificador é retornado em uma chamada bem-sucedida e é usado para enviar e receber dados e para sinalizar o comando. Esse identificador deve ser fechado chamando o método WSManCloseCommand . Esse parâmetro não pode ser NULL.

Valor retornado

Nenhum

Requisitos

Cliente mínimo com suporte	Windows 7
Servidor mínimo com suporte	Windows Server 2008 R2
Plataforma de Destino	Windows
Cabeçalho	wsman.h
Biblioteca	WsmSvc.lib
DLL	WsmSvc.dll
Redistribuível	Windows Management Framework no Windows Server 2008 com SP2 e Windows Vista com SP2