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 |