Partager via


WdsCliCreateSession, fonction (wdsclientapi.h)

Démarre une nouvelle session avec un serveur WDS.

Syntaxe

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

Paramètres

[in] pwszServer

Pointeur vers une valeur de chaîne qui contient le nom ou l’adresse IP du serveur WDS.

[in, optional] pCred

Pointeur vers une structure de WDS_CLI_CRED qui contient les informations d’identification du client. Ce paramètre peut être null pour une session sans authentification.

[out] phSession

Pointeur vers un handle pour la nouvelle session. Ce paramètre n’est pas modifié si la fonction échoue.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Pour fermer la session et libérer des ressources, utilisez la fonction WdsCliClose .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wdsclientapi.h
Bibliothèque WdsClientAPI.lib
DLL WdsClientAPI.dll

Voir aussi

WDS_CLI_CRED

WdsCliClose

Fonctions clientes des services de déploiement Windows