Método IWSMan::CreateSession (wsmandisp.h)
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.
[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 |