Función WSManCreateSession (wsman.h)

  • Artículo

Crea un objeto de sesión.

Sintaxis

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 el identificador de API devuelto por la llamada WSManInitialize . Este parámetro no puede ser NULL.

[in, optional] connection

Indica a qué protocolo y agente se va a conectar. Si este parámetro es NULL, la conexión tendrá como valor predeterminado localhost (127.0.0.1). Este parámetro puede ser un nombre de host simple o una dirección URL completa. El formato es el siguiente:

[transport://]host[:p ort][/prefix] donde:

Elemento Descripción
transporte HTTP o HTTPS. El valor predeterminado es HTTP.
host Puede estar en un nombre DNS, un nombre NetBIOS o una dirección IP.
port El valor predeterminado es 80 para HTTP y 443 para HTTPS. Los valores predeterminados se pueden cambiar en la configuración local.
prefix Cualquier cadena El valor predeterminado es "wsman". El valor predeterminado se puede cambiar en la configuración local.

flags

Reservado para uso futuro. Debe ser cero.

[in, optional] serverAuthenticationCredentials

Define el método de autenticación, como Negotiate, Kerberos, Digest, Basic o certificado de cliente. Si el mecanismo de autenticación es Negotiate, Kerberos, Digest o Basic, la estructura también puede contener las credenciales usadas para la autenticación. Si se usa la autenticación de certificados de cliente, se debe especificar la huella digital del certificado.

Si se especifican credenciales, este parámetro contiene el nombre de usuario y la contraseña de una cuenta local o de dominio. Si este parámetro es NULL, se usan las credenciales predeterminadas. Las credenciales predeterminadas son las credenciales en las que se ejecuta el subproceso actual. El cliente debe especificar explícitamente las credenciales cuando se usa la autenticación básica o implícita. Si se usan credenciales explícitas, tanto el nombre de usuario como la contraseña deben ser válidos. Para obtener más información sobre las credenciales de autenticación, consulte la estructura WSMAN_AUTHENTICATION_CREDENTIALS .

[in, optional] proxyInfo

Puntero a una estructura de WSMAN_PROXY_INFO que especifica información de proxy. Este valor puede ser NULL.

[out] session

Define el identificador de sesión que identifica de forma única la sesión. Este parámetro no puede ser NULL. Este identificador debe cerrarse llamando al método WSManCloseSession .

Valor devuelto

Si la función es correcta, el valor devuelto es cero. De lo contrario, el valor devuelto es un código de error.

Requisitos

   
Cliente mínimo compatible Windows 7
Servidor mínimo compatible Windows Server 2008 R2
Plataforma de destino Windows
Encabezado wsman.h
Library WsmSvc.lib
Archivo DLL WsmSvc.dll
Redistribuible Windows Management Framework en Windows Server 2008 con SP2 y Windows Vista con SP2