Método IWSMan::CreateSession (wsmandisp.h)

Cria um objeto Session que pode ser usado para operações de rede subsequentes.

Sintaxe

HRESULT CreateSession(
  [in]  BSTR      connection,
  [in]  long      flags,
  [in]  IDispatch *connectionOptions,
  [out] IDispatch **session
);

Parâmetros

[in] connection

O protocolo e o serviço ao qual se conectar, incluindo IPv4 ou IPv6. O formato das informações de conexão é o seguinte: <Sufixo deendereço>< de transporte><>. Para obter exemplos, consulte Comentários. Se nenhuma informação de conexão for fornecida, o computador local será usado.

[in] flags

Os sinalizadores de sessão que especificam o método de autenticação, como a autenticação Negotiate ou a autenticação Digest, para se conectar a um computador remoto. Esses sinalizadores também especificam outras informações de conexão de sessão, como codificação ou criptografia. Esse parâmetro deve conter um ou mais sinalizadores em __WSManSessionFlags para uma conexão remota. Para obter mais informações, consulte Constantes de sessão. Nenhuma configuração de sinalizador é necessária para uma conexão com o serviço WinRM no computador local.

Se nenhum sinalizador de autenticação for especificado, o Kerberos será usado, a menos que uma das seguintes condições seja verdadeira; nesse caso, Negotiate será usado:

• credenciais explícitas são fornecidas e o host de destino é confiável
• o host de destino é "localhost", "127.0.0.1" ou "[::1]"
• o computador cliente está em um grupo de trabalho e o host de destino é confiável

[in] connectionOptions

Um ponteiro para um objeto IWSManConnectionOptions que contém um nome de usuário e uma senha. O padrão é NULL.

[out] session

Um ponteiro para um novo objeto IWSManSession .

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A lista a seguir contém exemplos de formatos usados para especificar informações de conexão no parâmetro de conexão (ao criar uma sessão HTTPS, o < campo Endereço> deve corresponder ao nome do certificado do computador do servidor; caso contrário, ocorrerá uma falha):

• "https://service"

  Usa HTTPS para se conectar ao local do serviço Web padrão.

• "https://service.corp.com/websvcs/wsman"

  Usa HTTPS para se conectar ao local específico do serviço Web.

• "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]"

  Usa HTTPS e IPv6 com a porta padrão.

• "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]:9999/wsman"

  Usa HTTPS e IPv6 com a porta fornecida.

Requisitos

Confira também

IWSMan

WSMan.CreateSession