WSManSignalShell 関数 (wsman.h)

[アーティクル]
03/13/2024

コントロールコードを既存のコマンドまたはシェル自体に送信します。

構文

void WSManSignalShell(
  [in]           WSMAN_SHELL_HANDLE     shell,
  [in, optional] WSMAN_COMMAND_HANDLE   command,
                 DWORD                  flags,
  [in]           PCWSTR                 code,
  [in]           WSMAN_SHELL_ASYNC      *async,
  [out]          WSMAN_OPERATION_HANDLE *signalOperation
);

パラメーター

[in] shell

WSManCreateShell 呼び出しによって返されるハンドルを指定します。このパラメーターを NULL にすることはできません。

[in, optional] command

WSManRunShellCommand 呼び出しによって返されるコマンドハンドルを指定します。この値が NULL の場合、シグナルコードはシェルに送信されます。

flags

将来利用するために予約されています。 0 に設定する必要があります。

[in] code

コマンドまたはシェルに送信するシグナルコードを指定します。一般的なコードを次に示します。

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

シェルまたはコマンドプロンプトウィンドウが閉じられました。

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

Ctrl + C のシグナルが受信され、プロセスが停止しました。

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

Ctrl + BREAK のシグナルが受信され、プロセスが停止しました。

[in] async

非同期構造体を定義します。非同期構造体には、省略可能なユーザーコンテキストと必須のコールバック関数が含まれています。詳細については、 WSMAN_SHELL_ASYNC 構造に関するページを参照してください。このパラメーターは NULL にすることはできません。 WSManCloseOperation メソッドを呼び出して閉じる必要があります。

[out] signalOperation

シグナル操作の操作ハンドルを定義します。このハンドルは関数の正常な呼び出しから返され、シグナル操作を非同期的に取り消すために使用できます。このハンドルは、 WSManCloseOperation メソッドを呼び出して閉じる必要があります。このパラメーターを NULL にすることはできません。

戻り値

なし

必要条件

要件	値
サポートされている最小のクライアント	Windows 7
サポートされている最小のサーバー	Windows Server 2008 R2
対象プラットフォーム	Windows
ヘッダー	wsman.h
Library	WsmSvc.lib
[DLL]	WsmSvc.dll
再頒布可能パッケージ	Windows Server 2008 SP2、Windows Vista sp1、Windows Vista sp2 でのWindows Management Framework

次の方法で共有