Compartilhar via

Função WSManConnectShellCommand (wsman.h)

  • Artigo

Conecta-se a um comando existente em execução em um shell.

Sintaxe

void WSManConnectShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE   shell,
                 DWORD                flags,
  [in]           PCWSTR               commandID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [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] commandID

Uma cadeia de caracteres terminada em nulo que identifica um comando específico, atualmente em execução na sessão do servidor, à qual o cliente pretende se conectar.

[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, optional] connectXml

Um ponteiro para uma estrutura WSMAN_DATA que define um contexto aberto para a operação do shell de conexão. O conteúdo deve ser uma cadeia de caracteres XML válida. Este parâmetro pode ser NULL.

[in] async

Define uma estrutura assíncrona para conter um contexto de usuário opcional e uma função de retorno de chamada obrigatória. Para obter mais informações, consulte WSMAN_SHELL_ASYNC. Esse parâmetro não pode ser NULL.

[out] command

Esse identificador é retornado em uma chamada bem-sucedida e é usado para enviar e receber dados e para sinalizar o comando. Quando terminar de usar esse identificador, feche-o 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