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,因为 选项 参数设置为 WSMAN_OPTION_UNENCRYPTED_MESSAGES。 第二次调用失败,因为传递的选项适用于 HTTPS,传输由第一条消息设置为 HTTP。

要求

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