ServiceBase.OnCustomCommand(Int32) 方法

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

在衍生類別中實作時，當服務控制管理員 (SCM) 傳遞自訂命令給服務時，將執行 OnCustomCommand(Int32)。指定在具有指定參數值的命令發生時所要執行的動作。

protected:
 virtual void OnCustomCommand(int command);

protected virtual void OnCustomCommand (int command);

abstract member OnCustomCommand : int -> unit
override this.OnCustomCommand : int -> unit

Protected Overridable Sub OnCustomCommand (command As Integer)

傳送至服務的命令訊息。

OnCustomCommand 可讓您指定啟動、停止、暫停和繼續服務以外的其他功能。

SCM 不會檢查自訂命令，以確認服務是否支援 command 傳入的參數。它會將自訂命令直接傳遞至服務。如果服務無法辨識 command 參數，則不會執行任何動作。

自訂命令是由 ExecuteCommand 元件中的 ServiceController 語句所引發。使用 switch 語句或 if.。然後條件來處理您在服務上定義的自訂命令。

您可以在應用程式中 OnCustomCommand 定義的自訂命令唯一值是介於 128 到 255 之間。低於 128 的整數會對應至系統保留的值。

AutoLog如果屬性是 true ，自訂命令就像所有其他命令一樣，將專案寫入事件記錄檔，以報告方法執行成功或失敗。