WSManCreateSession, fonction (wsman.h)

Crée un objet de session.

Syntaxe

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
);

Paramètres

[in] apiHandle

Spécifie le handle d’API retourné par l’appel WSManInitialize . Ce paramètre ne peut pas être NULL.

[in, optional] connection

Indique le protocole et l’agent à connecter. Si ce paramètre a la valeur NULL, la connexion est définie par défaut sur localhost (127.0.0.1). Ce paramètre peut être un nom d’hôte simple ou une URL complète. Le format est le suivant :

[transport://]host[:p ort][/prefix] où :

Élément	Description
transport	HTTP ou HTTPS. La valeur par défaut est HTTP.
host	Il peut s’agir d’un nom DNS, d’un nom NetBIOS ou d’une adresse IP.
port	La valeur par défaut est 80 pour HTTP et 443 pour HTTPS. Les valeurs par défaut peuvent être modifiées dans la configuration locale.
prefix	Toute chaîne. La valeur par défaut est « wsman ». La valeur par défaut peut être modifiée dans la configuration locale.

flags

Réservé pour un usage futur. Doit être zéro.

[in, optional] serverAuthenticationCredentials

Définit la méthode d’authentification telle que Negotiate, Kerberos, Digest, De base ou certificat client. Si le mécanisme d’authentification est Negotiate, Kerberos, Digest ou De base, la structure peut également contenir les informations d’identification utilisées pour l’authentification. Si l’authentification par certificat client est utilisée, l’empreinte numérique du certificat doit être spécifiée.

Si des informations d’identification sont spécifiées, ce paramètre contient le nom d’utilisateur et le mot de passe d’un compte local ou d’un compte de domaine. Si ce paramètre a la valeur NULL, les informations d’identification par défaut sont utilisées. Les informations d’identification par défaut sont les informations d’identification sous lesquelles le thread actuel s’exécute. Le client doit spécifier explicitement les informations d’identification lorsque l’authentification De base ou Digest est utilisée. Si des informations d’identification explicites sont utilisées, le nom d’utilisateur et le mot de passe doivent être valides. Pour plus d’informations sur les informations d’identification d’authentification, consultez la structure WSMAN_AUTHENTICATION_CREDENTIALS .

[in, optional] proxyInfo

Pointeur vers une structure de WSMAN_PROXY_INFO qui spécifie des informations de proxy. Cette valeur peut être NULL.

[out] session

Définit le handle de session qui identifie la session de manière unique. Ce paramètre ne peut pas être NULL. Ce handle doit être fermé en appelant la méthode WSManCloseSession .

Valeur retournée

Si la fonction aboutit, la valeur de retour est égale à zéro. Sinon, la valeur de retour est un code d’erreur.

Spécifications

Client minimal pris en charge	Windows 7
Serveur minimal pris en charge	Windows Server 2008 R2
Plateforme cible	Windows
En-tête	wsman.h
Bibliothèque	WsmSvc.lib
DLL	WsmSvc.dll
Composant redistribuable	Windows Management Framework sur Windows Server 2008 avec SP2 et Windows Vista avec SP2