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
Library	WsmSvc.lib
[DLL]	WsmSvc.dll
再頒布可能パッケージ	Windows Server 2008 SP2 と Windows Vista sp2 のWindows Management Framework