WSManSetSessionOption 函数 (wsman.h)

  • 项目

设置会话的扩展选项集。

语法

DWORD WSManSetSessionOption(
  [in] WSMAN_SESSION_HANDLE session,
       WSManSessionOption   option,
  [in] WSMAN_DATA           *data
);

参数

[in] session

指定 WSManCreateSession 调用返回的会话句柄。 此参数不能为 NULL。

option

指定要设置的选项。 此参数必须设置为 WSManSessionOption 枚举中的值之一。

[in] data

指向定义选项值的 WSMAN_DATA 结构的指针。

返回值

此方法在成功时返回零。 否则，此方法将返回错误代码。

注解

如果使用为选项参数指定的不同值调用 WSManSetSessionOption 方法，则不同选项的顺序非常重要。 首次调用 WSManSetSessionOption 时，会为会话设置传输。 如果第二个调用请求不同类型的传输，则调用将失败。

例如，如果按以下顺序调用方法，则第二个方法调用将失败：

  • WSManSetSessionOption(WSMAN_OPTION_UNENCRYPTED_MESSAGES)
  • WSManSetSessionOption(WSMAN_OPTION_ALLOW_NEGOTIATE_IMPLICIT_CREDENTIALS)
第一个方法调用将传输设置为 HTTP，因为 option 参数设置为 WSMAN_OPTION_UNENCRYPTED_MESSAGES。 第二次调用失败，因为传递的选项适用于 HTTPS，并且第一条消息将传输设置为 HTTP。

要求

要求 值
最低受支持的客户端 Windows 7
最低受支持的服务器 Windows Server 2008 R2
目标平台 Windows
标头 wsman.h
Library WsmSvc.lib
DLL WsmSvc.dll
可再发行组件 Windows Management Framework Windows Server 2008 SP2、Windows Vista SP1 和 Windows Vista SP2 上的Windows Management Framework