struktur SERVICE_FAILURE_ACTIONSW (winsvc.h)
Mewakili tindakan yang harus dilakukan pengontrol layanan pada setiap kegagalan layanan. Layanan dianggap gagal ketika dihentikan tanpa melaporkan status SERVICE_STOPPED ke pengontrol layanan.
Untuk mengonfigurasi keadaan tambahan di mana tindakan kegagalan akan dijalankan, lihat SERVICE_FAILURE_ACTIONS_FLAG.
Sintaks
typedef struct _SERVICE_FAILURE_ACTIONSW {
DWORD dwResetPeriod;
LPWSTR lpRebootMsg;
LPWSTR lpCommand;
DWORD cActions;
SC_ACTION *lpsaActions;
} SERVICE_FAILURE_ACTIONSW, *LPSERVICE_FAILURE_ACTIONSW;
Anggota
dwResetPeriod
Waktu setelah itu untuk mengatur ulang jumlah kegagalan menjadi nol jika tidak ada kegagalan, dalam hitungan detik. Tentukan INFINITE untuk menunjukkan bahwa nilai ini tidak boleh diatur ulang.
lpRebootMsg
Pesan yang akan disiarkan ke pengguna server sebelum memulai ulang sebagai respons terhadap tindakan pengontrol layanan SC_ACTION_REBOOT .
Jika nilai ini NULL, pesan reboot tidak berubah. Jika nilainya adalah string kosong (""), pesan boot ulang akan dihapus dan tidak ada pesan yang disiarkan.
Anggota ini dapat menentukan string yang dilokalkan menggunakan format berikut:
@[path]dllname,-strID
String dengan strID pengidentifikasi dimuat dari nama dll; jalur bersifat opsional. Untuk informasi selengkapnya, lihat RegLoadMUIString.
Windows Server 2003 dan Windows XP: String yang dilokalkan tidak didukung sampai Windows Vista.
lpCommand
Baris perintah proses untuk fungsi CreateProcess untuk dijalankan sebagai respons terhadap tindakan pengontrol layanan SC_ACTION_RUN_COMMAND . Proses ini berjalan di bawah akun yang sama dengan layanan.
Jika nilai ini NULL, perintah tidak berubah. Jika nilainya adalah string kosong (""), perintah dihapus dan tidak ada program yang dijalankan saat layanan gagal.
cActions
Jumlah elemen dalam array lpsaActions .
Jika nilai ini adalah 0, tetapi lpsaActions bukan NULL, periode reset dan array tindakan kegagalan akan dihapus.
lpsaActions
Penunjuk ke array struktur SC_ACTION .
Jika nilai ini NULL, anggota cActions dan dwResetPeriod diabaikan.
Keterangan
Manajer kontrol layanan menghitung berapa kali setiap layanan gagal sejak sistem di-boot. Hitungan diatur ulang ke 0 jika layanan belum gagal selama dwResetPeriod detik. Ketika layanan gagal untuk Nkalinya, pengontrol layanan melakukan tindakan yang ditentukan dalam elemen [N-1] dari array lpsaActions . Jika N lebih besar dari cActions, pengontrol layanan akan mengulangi tindakan terakhir dalam array.
Catatan
Header winsvc.h mendefinisikan SERVICE_FAILURE_ACTIONS sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Header | winsvc.h (sertakan Windows.h) |