структура service_status_process

Служба повідомляється, коли профіль апаратних засобів комп'ютера змінився. Це дає можливість системі відправити повідомлення SERVICE_CONTROL_HARDWAREPROFILECHANGE службі.

Windows NT: Це значення не підтримується.

Служба повідомляється, коли стан живлення змінилося. Це дає можливість системі відправити повідомлення SERVICE_CONTROL_POWEREVENT службі.

Windows NT: Це значення не підтримується.

Служба повідомляється, коли стан сесії комп'ютера змінилося. Це дає можливість системі відправити повідомлення SERVICE_CONTROL_SESSIONCHANGE службі.

Код помилки, який служба використовує, щоб повідомити про помилку, яка відбувається тоді, коли вона запускається або зупиняється. Щоб повернути код помилки, який визначений службі, служба повинна встановити це значення в ERROR_SERVICE_SPECIFIC_ERROR. вказуючи, що член структури dwServiceSpecificExitCode має в своєму складі код помилки. Служба повинна встановити це значення в NO_ERROR. коли вона запускається і після нормального завершення.

Спеціальний для служби код помилки, який служба повертає, коли відбувається помилка в той час як служба запускається або зупиняється. Це значення ігнорується, якщо член структури dwWin32ExitCode не встановлюється в ERROR_SERVICE_SPECIFIC_ERROR.

Значення контрольної точки служби періодично збільшується на одиницю, щоб повідомити про своє просування в ході довгого запуску, зупинки, паузи або продовження операції. Наприклад, служба повинна збільшувати це значення, оскільки вона завершує кожного кроку своєї ініціалізації, коли вона запускається. Інтерфейс програми, яка викликала процедуру служби, використовує це значення, щоб відстежити просування служби в ході довгої операції. Це значення не дійсно і має бути нулем тоді, коли служба не запускається, не зупиняється, робить паузу або операція продовжує очікувати.

Передбачуваний час, необхідний для очікування пуску, зупинки, паузи або операції очікування продовження, в мілісекундах. Перш, ніж зазначений час закінчиться, служба повинна зробити свій наступний виклик функції SetServiceStatus або зі збільшеним значенням dwCheckPoint. або зі зміною в dwCurrentState. Якщо час, заданий при передачі параметрів dwWaitHint і dwCheckPoint не було збільшено, або параметрdwCurrentState не змінився, диспетчер управління службами або програма управління службою можуть припустити, що сталася помилка і служба повинна бути зупинена.

Ідентифікатор процесу (PID) служби.

Цей член структури може бути одним з наступних значень.

Схожі статті