Compartilhar via


Função WdsCliCreateSession (wdsclientapi.h)

Inicia uma nova sessão com um servidor WDS.

Sintaxe

HRESULT WDSCLIAPI WdsCliCreateSession(
  [in]           PWSTR         pwszServer,
  [in, optional] PWDS_CLI_CRED pCred,
  [out]          PHANDLE       phSession
);

Parâmetros

[in] pwszServer

Um ponteiro para um valor de cadeia de caracteres que contém o nome ou o endereço IP do servidor WDS.

[in, optional] pCred

Um ponteiro para uma estrutura WDS_CLI_CRED que contém as credenciais do cliente. Esse parâmetro pode ser nulo para uma sessão sem autenticação.

[out] phSession

Um ponteiro para um identificador para a nova sessão. Esse parâmetro não será modificado se a função não for bem-sucedida.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para fechar a sessão e liberar recursos, use a função WdsCliClose .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wdsclientapi.h
Biblioteca WdsClientAPI.lib
DLL WdsClientAPI.dll

Confira também

WDS_CLI_CRED

WdsCliClose

Funções de cliente dos Serviços de Implantação do Windows