Compartilhar via

Função WSManRunShellCommandEx (wsman.h)

  • Artigo

Fornece a mesma funcionalidade que a função WSManRunShellCommand , com a adição de uma opção de ID de comando. Se o servidor der suporte ao protocolo, ele criará a instância de comando usando a ID especificada pelo cliente. Se já existir um comando com a ID especificada, o servidor não criará a instância de comando. Essa nova funcionalidade só estará disponível quando o aplicativo cliente passar o sinalizador WSMAN_FLAG_REQUESTED_API_VERSION_1_1 como parte da chamada para a função WSManInitialize .

Sintaxe

void WSManRunShellCommandEx(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandId,
  [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 0.

[in] commandId

A ID de comando especificada pelo cliente.

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

Retornar valor

Nenhum

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho wsman.h
Biblioteca WsmSvc.lib
DLL WsmSvc.dll