WSManConnectShell 函式 (wsman.h)

連接到現有的伺服器會話。

語法

void WSManConnectShell(
  [in, out]      WSMAN_SESSION_HANDLE session,
                 DWORD                flags,
  [in]           PCWSTR               resourceUri,
  [in]           PCWSTR               shellID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_SHELL_HANDLE   *shell
);

參數

[in, out] session

指定 WSManCreateSession 函 式所傳回的會話句柄。 此參數不可以是 NULL。

flags

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

[in] resourceUri

定義將建立連線的殼層類型。 殼層類型是由唯一 URI 所定義，因此呼叫所傳回的殼層對象取決於此參數所指定的 URI。 resourceUri 參數不能是 NULL，而且它是以 Null 結尾的字串。

[in] shellID

指定與用戶端想要連線的伺服器殼層會話相關聯的殼層標識碼。

[in, optional] options

WSMAN_OPTION_SET 結構的指標，指定殼層的一組選項。 這是選擇性參數。

[in, optional] connectXml

定義連接殼層作業開啟內容的 WSMAN_DATA 結構的指標。 內容應該是有效的 XML 字串。 此參數可以是 NULL。

[in] async

定義異步結構，其中包含選擇性的使用者內容和強制回呼函式。 如需詳細資訊 ，請參閱WSMAN_SHELL_ASYNC 結構。 此參數不可以是 NULL。

[out] shell

指定可唯一識別 resourceURI 所傳回之殼層對象的殼層句柄。 資源句柄會追蹤殼層的用戶端端點，並由其他 WinRM 方法用來與殼層對象互動。 呼叫 WSManCloseShell 方法時，應該刪除殼層物件。 此參數不可以是 NULL。

傳回值

無

備註

連接到 ShellId 參數所識別的現有伺服器殼層會話。 這會建置由傳回參數殼層表示的必要客戶端內容，可用來執行後續作業，例如在伺服器殼層會話上執行命令和傳送和接收輸出。 此 WSManConnectShell 函式不會針對目前與伺服器殼層會話相關聯的任何命令，自動建構客戶端內容。

規格需求

需求	值
最低支援的用戶端	Windows 8
最低支援的伺服器	Windows Server 2012
目標平台	Windows
標頭	wsman.h
程式庫	WsmSvc.lib
Dll	WsmSvc.dll
可轉散發套件	Windows Server 2012 上的 WinRM。