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 |