共用方式為

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 結構的指標。

傳回值

這個方法會在成功時傳回零。 否則，此方法會傳回錯誤碼。

備註

如果使用針對 option 參數指定的不同值呼叫 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
程式庫 WsmSvc.lib
Dll WsmSvc.dll
可轉散發套件 windows Server 2008 SP2、Windows Vista SP1 和 Windows Vista SP2 上的 Windows Management Framework