ServiceBase.OnCustomCommand(Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Saat diimplementasikan dalam kelas turunan, OnCustomCommand(Int32) dijalankan ketika Service Control Manager (SCM) meneruskan perintah kustom ke layanan. Menentukan tindakan yang harus diambil ketika perintah dengan nilai parameter yang ditentukan terjadi.
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)Parameter
- command
- Int32
Pesan perintah yang dikirim ke layanan.
Keterangan
OnCustomCommand memungkinkan Anda menentukan fungsionalitas tambahan selain memulai, menghentikan, menjeda, dan melanjutkan layanan.
SCM tidak memeriksa perintah kustom untuk memverifikasi apakah layanan mendukung parameter yang command diteruskan. Ini meneruskan perintah kustom langsung ke layanan. Jika layanan tidak mengenali command parameter, layanan tidak melakukan apa pun.
Perintah kustom dimunculkan oleh ExecuteCommand pernyataan dalam komponen ServiceController . Gunakan pernyataan pengalihan atau if.. lalu kondisi untuk menangani perintah kustom yang Anda tentukan pada layanan Anda.
Satu-satunya nilai untuk perintah kustom yang dapat Anda tentukan dalam aplikasi atau penggunaan OnCustomCommand adalah nilai antara 128 dan 255. Bilangan bulat di bawah 128 sesuai dengan nilai yang dicadangkan sistem.
AutoLog Jika properti adalah true, perintah kustom, seperti semua perintah lainnya, tulis entri ke log peristiwa untuk melaporkan apakah eksekusi metode berhasil atau gagal.
