Método IWSMan::CreateSession (wsmandisp.h)

  • Artículo

Crea un objeto Session que se puede usar para las operaciones de red posteriores.

Sintaxis

HRESULT CreateSession(
  [in]  BSTR      connection,
  [in]  long      flags,
  [in]  IDispatch *connectionOptions,
  [out] IDispatch **session
);

Parámetros

[in] connection

Protocolo y servicio al que se conectará, incluidos IPv4 o IPv6. El formato de la información de conexión es el siguiente: <Sufijo>de dirección>< de transporte><. Para obtener ejemplos, vea Comentarios. Si no se proporciona información de conexión, se usa el equipo local.

[in] flags

Marcas de sesión que especifican el método de autenticación, como la autenticación Negotiate o la autenticación implícita, para conectarse a un equipo remoto. Estas marcas también especifican otra información de conexión de sesión, como la codificación o el cifrado. Este parámetro debe contener una o varias de las marcas de __WSManSessionFlags para una conexión remota. Para obtener más información, vea Constantes de sesión. No se requiere ninguna configuración de marca para una conexión con el servicio WinRM en el equipo local.

Si no se especifican marcas de autenticación, Kerberos se usa a menos que se cumple una de las condiciones siguientes, en cuyo caso se usa Negotiate:

  • se proporcionan credenciales explícitas y el host de destino es de confianza
  • el host de destino es "localhost", "127.0.0.1" o "[::1]"
  • el equipo cliente está en un grupo de trabajo y el host de destino es de confianza.
Para obtener más información, consulte Autenticación para conexiones remotas y el parámetro connectionOptions .

[in] connectionOptions

Puntero a un objeto IWSManConnectionOptions que contiene un nombre de usuario y una contraseña. El valor predeterminado es NULL.

[out] session

Puntero a un nuevo objeto IWSManSession .

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Observaciones

La lista siguiente contiene ejemplos de formatos usados para especificar información de conexión en el parámetro de conexión (al crear una sesión HTTPS, el < campo Dirección> debe coincidir con el nombre del certificado del equipo del servidor; de lo contrario, se produce un error):

  • "https://service"

    Usa HTTPS para conectarse a la ubicación predeterminada del servicio web.

  • "https://service.corp.com/websvcs/wsman"

    Usa HTTPS para conectarse a la ubicación específica del servicio web.

  • "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]"

    Usa HTTPS e IPv6 con el puerto predeterminado.

  • "https://[E3D7:0000:0000:0000:51F4:9BC8:C0A8:6420]:9999/wsman"

    Usa HTTPS e IPv6 con el puerto especificado.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wsmandisp.h
Library WSManDisp.tlb
Archivo DLL WSMAuto.dll

Consulte también

IWSMan

WSMan.CreateSession