Função WSManConnectShell (wsman.h)

Conecta-se a uma sessão de servidor existente.

Sintaxe

void WSManConnectShell(
  [in, out]      WSMAN_SESSION_HANDLE session,
                 DWORD                flags,
  [in]           PCWSTR               resourceUri,
  [in]           PCWSTR               shellID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_SHELL_HANDLE   *shell
);

Parâmetros

[in, out] session

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

flags

Reservado para uso futuro. Deve ser zero.

[in] resourceUri

Define o tipo de shell ao qual a conexão será feita. O tipo de shell é definido por um URI exclusivo, portanto, o objeto shell retornado pela chamada depende do URI especificado por esse parâmetro. O parâmetro resourceUri não pode ser NULL e é uma cadeia de caracteres terminada em nulo.

[in] shellID

Especifica o identificador de shell associado à sessão do shell do servidor à qual o cliente pretende se conectar.

[in, optional] options

Um ponteiro para uma estrutura WSMAN_OPTION_SET que especifica um conjunto de opções para o shell. Esse parâmetro é opcional.

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

[out] shell

Especifica um identificador de shell que identifica exclusivamente o objeto shell que foi retornado pelo resourceURI. O identificador de recurso rastreia 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.

Retornar valor

Nenhum

Comentários

Conecta-se a uma sessão de shell de servidor existente identificada pelo parâmetro ShellId . Isso cria o contexto do lado do cliente necessário, representado pelo shell de parâmetro de retorno, que pode ser usado para executar operações subsequentes, como executar comandos e enviar e receber saída na sessão do shell do servidor. Essa função WSManConnectShell não constrói automaticamente os contextos do lado do cliente para quaisquer comandos associados atualmente à sessão do shell do servidor.

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
Redistribuível	WinRM no Windows Server 2012.