WSMAN_PLUGIN_SIGNAL回呼函式 (wsman.h)

定義外掛程式的訊號回呼。 從用戶端呼叫接收輸入訊號時，會呼叫此函式。

這個方法的 DLL 進入點名稱必須是 WSManPluginSignal。

語法

WSMAN_PLUGIN_SIGNAL WsmanPluginSignal;

void WsmanPluginSignal(
  [in]           WSMAN_PLUGIN_REQUEST *requestDetails,
  [in]           DWORD flags,
  [in]           PVOID shellContext,
  [in, optional] PVOID commandContext,
  [in]           PCWSTR code
)
{...}

參數

[in] requestDetails

WSMAN_PLUGIN_REQUEST 結構的指標，指定要求的資源 URI、選項、地區設定、關機旗標和句柄。

[in] flags

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

[in] shellContext

指定建立殼層時收到的內容。

[in, optional] commandContext

如果此要求是以命令而非殼層為目標，則這是 從 winrm 建立 作業傳回的內容;否則，此參數為 NULL。

[in] code

指定從用戶端接收的訊號。 下列程式代碼很常見。

WSMAN_SIGNAL_SHELL_CODE_TERMINATE

殼層或命令提示字元視窗已關閉。 外掛程式應該呼叫 WSManPluginOperationComplete 函式 。

WSMAN_SIGNAL_SHELL_CODE_CTRL_C

已收到 CTRL+C 的訊號，且進程已停止。 外掛程式應該呼叫 WSManPluginOperationComplete 函式 。

WSMAN_SIGNAL_SHELL_CODE_CTRL_BREAK

已收到 CTRL+BREAK 的訊號，且進程已停止。 外掛程式應該呼叫 WSManPluginOperationComplete 函式 。

傳回值

無

備註

您可以接收訊號來處理 CTRL+C 序列，或許多其他類型的自定義訊號之一。 每個收到的訊號都會呼叫回呼一次。 外掛程式會決定哪些訊號會導致命令和/或殼層關閉。 因為訊號是殼層特定的，所以外掛程式必須藉由呼叫 WSManPluginOperationComplete 方法來起始關機。 針對每個呼叫，外掛程式應該呼叫 WSManPluginOperationComplete 來認可回條，並允許接收下一個訊號。

規格需求