Compartilhar via


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 do WSManCreateShell. Esse parâmetro não pode ser NULL.

flags

Reservado para uso futuro. Deve ser zero.

[in] commandLine

Define um cadeia de caracteres nulaterminada 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 de 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. Esse 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 de 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 sinalizar o comando. Esse identificador deve ser fechado chamando o método WSManCloseCommand. Esse parâmetro não pode ser NULL.

Valor de retorno

Nenhum

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 7
servidor com suporte mínimo Windows Server 2008 R2
da Plataforma de Destino Windows
cabeçalho wsman.h
biblioteca WsmSvc.lib
de DLL WsmSvc.dll
redistribuível Windows Management Framework no Windows Server 2008 com SP2 e Windows Vista com SP2