共用方式為

WSManRunShellCommand 函式 (wsman.h)

  • 發行項

啟動現有殼層內的命令執行，且不會等候命令完成。

語法

void WSManRunShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandLine,
  [in, optional] WSMAN_COMMAND_ARG_SET *args,
  [in, optional] WSMAN_OPTION_SET      *options,
  [in]           WSMAN_SHELL_ASYNC     *async,
  [out]          WSMAN_COMMAND_HANDLE  *command
);

參數

[in, out] shell

指定 WSManCreateShell 呼叫所傳回的殼層控制碼。 此參數不可為 Null。

flags

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

[in] commandLine

定義必要的 Null終止字串，表示要執行的命令。 一般而言，命令會指定，而不需另外指定任何引數。 不過，使用者可以使用此參數來指定命令列和所有引數。 如果為 commandLine 參數指定引數， 則 args 參數應該是 Null。

[in, optional] args

定義引數值陣列 的WSMAN_COMMAND_ARG_SET 結構的指標，這些引數值會在建立時傳遞至命令。 如果不需要引數，此參數應該是 Null。

[in, optional] options

定義命令的一組選項。 這些選項會傳遞至服務，以修改或精簡命令執行。 此參數可以是 Null。 如需選項的詳細資訊，請參閱 WSMAN_OPTION_SET。

[in] async

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

[out] command

定義與殼層內命令相關聯的命令物件。 此控制碼會在成功呼叫時傳回，並用來傳送和接收資料，以及發出命令訊號。 呼叫 WSManCloseCommand 方法應該關閉此控制碼。 此參數不可為 Null。

傳回值

無

規格需求

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