共用方式為

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
目標平臺 窗戶
標頭 wsman.h
連結庫 WsmSvc.lib
DLL WsmSvc.dll
可轉散發 Windows Server 2008 SP2、Windows Vista SP1 和 Windows Vista SP2 上的 Windows Management Framework