Compartilhar via


Função WSManCreateSession (wsman.h)

Cria um objeto de sessão.

Sintaxe

DWORD WSManCreateSession(
  [in]           WSMAN_API_HANDLE                 apiHandle,
  [in, optional] PCWSTR                           connection,
                 DWORD                            flags,
  [in, optional] WSMAN_AUTHENTICATION_CREDENTIALS *serverAuthenticationCredentials,
  [in, optional] WSMAN_PROXY_INFO                 *proxyInfo,
  [out]          WSMAN_SESSION_HANDLE             *session
);

Parâmetros

[in] apiHandle

Especifica o identificador de API retornado pela chamada WSManInitialize . Esse parâmetro não pode ser NULL.

[in, optional] connection

Indica a qual protocolo e agente se conectar. Se esse parâmetro for NULL, a conexão usará localhost como padrão (127.0.0.1). Esse parâmetro pode ser um nome de host simples ou uma URL completa. O formato é o seguinte:

[transport://]host[:p ort][/prefix] em que:

Elemento Descrição
transporte HTTP ou HTTPS. O padrão é HTTP.
host Pode estar em um nome DNS, nome NetBIOS ou endereço IP.
porta O padrão é 80 para HTTP e 443 para HTTPS. Os padrões podem ser alterados na configuração local.
prefixo Qualquer cadeia de caracteres. O padrão é "wsman". O padrão pode ser alterado na configuração local.

flags

Reservado para uso futuro. Deve ser zero.

[in, optional] serverAuthenticationCredentials

Define o método de autenticação, como Negotiate, Kerberos, Digest, Basic ou certificado do cliente. Se o mecanismo de autenticação for Negotiate, Kerberos, Digest ou Basic, a estrutura também poderá conter as credenciais usadas para autenticação. Se a autenticação de certificado do cliente for usada, a impressão digital do certificado deverá ser especificada.

Se as credenciais forem especificadas, esse parâmetro conterá o nome de usuário e a senha de uma conta local ou conta de domínio. Se esse parâmetro for NULL, as credenciais padrão serão usadas. As credenciais padrão são as credenciais nas quais o thread atual está sendo executado. O cliente deve especificar explicitamente as credenciais quando a autenticação Básica ou Digest for usada. Se as credenciais explícitas forem usadas, o nome de usuário e a senha deverão ser válidos. Para obter mais informações sobre as credenciais de autenticação, consulte a estrutura WSMAN_AUTHENTICATION_CREDENTIALS .

[in, optional] proxyInfo

Um ponteiro para uma estrutura WSMAN_PROXY_INFO que especifica informações de proxy. Esse valor pode ser NULL.

[out] session

Define o identificador de sessão que identifica exclusivamente a sessão. Esse parâmetro não pode ser NULL. Esse identificador deve ser fechado chamando o método WSManCloseSession .

Valor retornado

Se a função obtiver êxito, o valor retornado será zero. Caso contrário, o valor retornado será um código de erro.

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