IWSMan：：CreateSession 方法 (wsmandisp.h)

创建一个 会话 对象，该对象随后可用于后续网络操作。

语法

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

参数

[in] connection

要连接到的协议和服务，包括 IPv4 或 IPv6。 连接信息的格式如下： <传输><地址><后缀>。 有关示例，请参阅备注。 如果未提供连接信息，则使用本地计算机。

[in] flags

会话标志，指定用于连接到远程计算机的身份验证方法，例如 协商身份验证 或 摘要式身份验证。 这些标志还指定其他会话连接信息，例如编码或加密。 对于远程连接，此参数必须包含 __WSManSessionFlags 中的一个或多个标志。 有关详细信息，请参阅 会话常量。 连接到本地计算机上的 WinRM 服务不需要任何标志设置。

如果未指定身份验证标志，则使用 Kerberos，除非满足以下条件之一，在这种情况下使用 Negotiate：

• 提供显式凭据，并且目标主机受信任
• 目标主机为“localhost”、“127.0.0.1”或“[：：1]”
• 客户端计算机位于工作组中，并且目标主机受信任

有关详细信息，请参阅 远程连接的身份验证 和 connectionOptions 参数。

[in] connectionOptions

指向包含用户名和密码的 IWSManConnectionOptions 对象的指针。 默认值为 NULL。

[out] session

指向新 IWSManSession 对象的指针。

返回值

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

以下列表包含用于在创建 HTTPS 会话时在连接参数 (指定 连接 信息的格式示例， <“地址”> 字段必须与服务器计算机证书名称匹配，否则) 失败：

• "https://service"

  使用 HTTPS 连接到默认 Web 服务位置。

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

  使用 HTTPS 连接到特定的 Web 服务位置。

• “https://[E3D7：0000：0000：0000：51F4：9BC8：C0A8：6420]”

  使用具有默认端口的 HTTPS 和 IPv6。

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

  使用具有给定端口的 HTTPS 和 IPv6。

要求

最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	wsmandisp.h
Library	WSManDisp.tlb
DLL	WSMAuto.dll

另请参阅

IWSMan

WSMan.CreateSession