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 -> unitProtected Overridable Sub OnCustomCommand (command As Integer)參數
- command
- Int32
傳送至服務的命令訊息。
備註
OnCustomCommand 可讓您指定啟動、停止、暫停和繼續服務以外的其他功能。
SCM 不會檢查自訂命令，以確認服務是否支援 command 傳入的參數。 它會將自訂命令直接傳遞至服務。 如果服務無法辨識 command 參數，則不會執行任何動作。
自訂命令是由 ExecuteCommand 元件中的 ServiceController 語句所引發。 使用 switch 語句或 if.。然後條件來處理您在服務上定義的自訂命令。
您可以在 應用程式中 OnCustomCommand 定義的自訂命令唯一值是介於 128 到 255 之間。 低於 128 的整數會對應至系統保留的值。
AutoLog如果 屬性是 true ，自訂命令就像所有其他命令一樣，將專案寫入事件記錄檔，以報告方法執行成功或失敗。