WSManSignalShell 函式 (wsman.h)

將控件程式代碼傳送至現有的命令或殼層本身。

語法

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

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

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

傳回值

無

規格需求