WSManRunShellCommandEx 函式 (wsman.h)

提供與 WSManRunShellCommand 函式相同的功能，並新增命令標識符選項。 如果伺服器支援通訊協定，它會使用用戶端指定的標識碼來建立命令實例。 如果具有指定標識碼的命令已經存在，伺服器將無法建立命令實例。 只有在用戶端應用程式將 WSMAN_FLAG_REQUESTED_API_VERSION_1_1 旗標當做 WSManInitialize 函式呼叫的一部分傳遞時，才能使用這項新功能。

語法

void WSManRunShellCommandEx(
  [in, out]      WSMAN_SHELL_HANDLE    shell,
                 DWORD                 flags,
  [in]           PCWSTR                commandId,
  [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

保留供未來使用。 必須是 0。

[in] commandId

用戶端指定的命令標識碼。

[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。

傳回值

無

規格需求