WSManCreateShell 函式 (wsman.h)

建立殼層物件。 傳回的殼層控制碼會識別定義可執行命令之內容的物件。 內容是由環境變數、輸入和輸出資料流程和工作目錄所定義。 內容可能會直接影響命令的行為。 殼層內容是在連接參數指定的遠端電腦上建立，並使用認證參數進行驗證。

語法

void WSManCreateShell(
  [in, out]      WSMAN_SESSION_HANDLE     session,
                 DWORD                    flags,
  [in]           PCWSTR                   resourceUri,
  [in, optional] WSMAN_SHELL_STARTUP_INFO *startupInfo,
  [in, optional] WSMAN_OPTION_SET         *options,
  [in, optional] WSMAN_DATA               *createXml,
  [in]           WSMAN_SHELL_ASYNC        *async,
  [out]          WSMAN_SHELL_HANDLE       *shell
);

參數

[in, out] session

指定 WSManCreateSession 呼叫所傳回的會話控制碼。 此參數不可為 Null。

flags

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

[in] resourceUri

定義要建立的殼層類型。 殼層類型是由唯一 URI 所定義。 呼叫所傳回的實際殼層物件取決於指定的 URI。 此參數不可為 Null。 若要建立 Windows cmd.exe 殼層，請使用 WSMAN_CMDSHELL_URI 資源 URI。

[in, optional] startupInfo

WSMAN_SHELL_STARTUP_INFO結構的指標，指定殼層的輸入和輸出資料流程、工作目錄、閒置逾時和選項。

如果此參數為 Null，則會使用預設值。

[in, optional] options

WSMAN_OPTION_SET結構的指標，指定殼層的一組選項。

[in, optional] createXml

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

[in] async

定義非同步結構。 非同步結構包含選擇性的使用者內容和強制回呼函式。 如需詳細資訊，請參閱 WSMAN_SHELL_ASYNC 結構。 此參數不能是 Null ，而且應該藉由呼叫 WSManCloseShell 方法來關閉。

[out] shell

定義可唯一識別殼層物件的殼層控制碼。 資源控制碼可用來追蹤殼層的用戶端端點，並由其他 WinRM 方法用來與殼層物件互動。 呼叫 WSManCloseShell 方法時，應該刪除殼層物件。 此參數不可為 Null。

傳回值

無

規格需求