Compartilhar via

Função WSManCreateShell (wsman.h)

  • Artigo

Cria um objeto shell. O identificador de shell retornado identifica um objeto que define o contexto no qual os comandos podem ser executados. O contexto é definido pelas variáveis de ambiente, pelos fluxos de entrada e saída e pelo diretório de trabalho. O contexto pode afetar diretamente o comportamento de um comando. Um contexto de shell é criado no computador remoto especificado pelo parâmetro de conexão e autenticado usando o parâmetro de credenciais.

Sintaxe

void WSManCreateShell(
  [in, out]      WSMAN_SESSION_HANDLE     session,
                 DWORD                    flags,
  [in]           PCWSTR                   resourceUri,
  [in, optional] WSMAN_SHELL_STARTUP_INFO *startupInfo,
  [in, optional] WSMAN_OPTION_SET         *options,
  [in, optional] WSMAN_DATA               *createXml,
  [in]           WSMAN_SHELL_ASYNC        *async,
  [out]          WSMAN_SHELL_HANDLE       *shell
);

Parâmetros

[in, out] session

Especifica o identificador de sessão retornado por uma chamada WSManCreateSession . Esse parâmetro não pode ser NULL.

flags

Reservado para uso futuro. Deve ser zero.

[in] resourceUri

Define o tipo de shell a ser criado. O tipo de shell é definido por um URI exclusivo. O objeto shell real retornado pela chamada depende do URI especificado. Esse parâmetro não pode ser NULL. Para criar um shell do Windows cmd.exe, use o URI do recurso WSMAN_CMDSHELL_URI .

[in, optional] startupInfo

Um ponteiro para uma estrutura WSMAN_SHELL_STARTUP_INFO que especifica os fluxos de entrada e saída, diretório de trabalho, tempo limite ocioso e opções para o shell.

Se esse parâmetro for NULL, os valores padrão serão usados.

[in, optional] options

Um ponteiro para uma estrutura WSMAN_OPTION_SET que especifica um conjunto de opções para o shell.

[in, optional] createXml

Um ponteiro para uma estrutura WSMAN_DATA que define um contexto aberto para o shell. 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. 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 WSManCloseShell .

[out] shell

Define um identificador de shell que identifica exclusivamente o objeto shell. O identificador de recurso é usado para acompanhar o ponto de extremidade do cliente para o shell e é usado por outros métodos WinRM para interagir com o objeto shell. O objeto shell deve ser excluído chamando o método WSManCloseShell . 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