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ù :

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