wsmanCreateSession 函式 (wsman.h)

建立會話物件。

語法

DWORD WSManCreateSession(
  [in]           WSMAN_API_HANDLE                 apiHandle,
  [in, optional] PCWSTR                           connection,
                 DWORD                            flags,
  [in, optional] WSMAN_AUTHENTICATION_CREDENTIALS *serverAuthenticationCredentials,
  [in, optional] WSMAN_PROXY_INFO                 *proxyInfo,
  [out]          WSMAN_SESSION_HANDLE             *session
);

參數

[in] apiHandle

指定 WSManInitialize 呼叫所傳回的 API 控制碼。 此參數不可為 Null。

[in, optional] connection

指出要連線的通訊協定和代理程式。 如果此參數為 Null，則連線預設為 localhost (127.0.0.1) 。 此參數可以是簡單的主機名稱或完整的 URL。 格式如下：

[transport://]host[:p ort][/prefix] 其中：

元素	描述
傳輸	HTTP 或 HTTPS。 預設值為 HTTP。
主機	可以位於 DNS 名稱、NetBIOS 名稱或 IP 位址中。
連接埠	針對 HTTP 預設為 80，而 HTTPS 則預設為 443。 您可以在本機組態中變更預設值。
prefix	任何字串。 預設值為 「wsman」。 您可以在本機組態中變更預設值。

flags

保留供未來使用。 必須為零。

[in, optional] serverAuthenticationCredentials

定義驗證方法，例如 Negotiate、Kerberos、Digest、Basic 或用戶端憑證。 如果驗證機制為 Negotiate、Kerberos、Digest 或 Basic，結構也可以包含用於驗證的認證。 如果使用用戶端憑證驗證，則必須指定憑證指紋。

如果指定認證，此參數會包含本機帳戶或網域帳戶的使用者名稱和密碼。 如果此參數為 Null，則會使用預設認證。 預設認證是目前線程執行所在的認證。 使用基本或摘要式驗證時，用戶端必須明確指定認證。 如果使用明確認證，則使用者名稱和密碼都必須有效。 如需驗證認證的詳細資訊，請參閱 WSMAN_AUTHENTICATION_CREDENTIALS 結構。

[in, optional] proxyInfo

指定 Proxy 資訊的 WSMAN_PROXY_INFO 結構的指標。 此值可以是 Null。

[out] session

定義可唯一識別會話的會話控制碼。 此參數不可為 Null。 呼叫 WSManCloseSession 方法應該關閉此控制碼。

傳回值

如果此函式成功，則傳回值為零。 否則，傳回值是錯誤碼。

規格需求

最低支援的用戶端	Windows 7
最低支援的伺服器	Windows Server 2008 R2
目標平台	Windows
標頭	wsman.h
程式庫	WsmSvc.lib
Dll	WsmSvc.dll
可轉散發套件	windows Server 2008 SP2 和 Windows Vista sp2 上的Windows Management Framework