На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

Handler



A Handler function is a function that a service process specifies as the control handling function of a particular service. The function can have any application-defined name.

VOID WINAPI Handler(

DWORD fdwControl // requested control code
);


Parameters

fdwControl

Indicates the requested control code. This value can be one of the standard control codes in the table, or it can be a user-defined control code in the range of 128 to 255, inclusive. For user-defined control codes, the service defines the action associated with the control code.

Value Meaning
SERVICE_CONTROL_STOP
Requests the service to stop.
SERVICE_CONTROL_PAUSE
Requests the service to pause.
SERVICE_CONTROL_CONTINUE
Requests the paused service to resume.
SERVICE_CONTROL_INTERROGATE
Requests the service to immediately report its current status information to the service control manager.
SERVICE_CONTROL_SHUTDOWN
Requests the service to perform cleanup tasks, because the system is shutting down. Due to extremely limited time available for shutdown, this control should only be used by services that absolutely need to shut down ѕ for instance, when the eventlog service needs to clear a dirty bit in the files that it maintains, or when the server service needs to shut down so that network connections aren't made when the system is in the shutdown state.If the service takes time to shut down, and sends out STOP_PENDING status messages, it is highly recommended that these messages include a waithint so that the service controller will know how long to wait before indicating to the system that service shutdown is complete. The system gives the service control manager a limited amount of time (about 20 seconds) to complete service shutdown, after which time system shutdown proceeds regardless of whether service shutdown is complete.


Return Values

This function does not return a value.

Remarks

When a Win32 service is started, its ServiceMain function should immediately call the RegisterServiceCtrlHandler function to specify a Handler function to handle control requests.
Whenever it receives a control request from the service control manager, the control dispatcher in the main thread of a Win32 service process invokes the control handler function for the specified service. After handling the control request, the control handler must call the SetServiceStatus function to report its current status to the service control manager.

See Also

RegisterServiceCtrlHandler, ServiceMain, SetServiceStatus


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

Вручитель



Функция Вручителя является функцией, что процесс услуги определяет как управление, обрабатывающее функцию конкретной услуги. Функция может иметь любое определенное прикладное имя.

НЕДЕЙСТВИТЕЛЬНЫЙ Вручитель WINAPI(

ПОПРОШЕННЫЙ управляющий код DWORD fdwControl //
);


Параметры

fdwControl

Указывает попрошенный управляющий код. Эта величина может быть одним из стандартных управляющих кодов на столе, или это может быть управляющим кодом определенного потребителя в дипазоне 128 на 255, включающее. Для управляющих кодов определенного потребителя, услуга определяет действие связанное управляющим кодом.

Оцените Значение SERVICE_CONTROL_STOP Просит услугу, чтобы прекращаться.
SERVICE_CONTROL_PAUSE Просит услугу, чтобы останавливаться.
SERVICE_CONTROL_CONTINUE Просит остановленную услугу, чтобы продолжаться.
SERVICE_CONTROL_INTERROGATE
Запрашивает услугу, чтобы немедленно сообщать свою текущую информацию статуса управляющему менеджеру услуги.
SERVICE_CONTROL_SHUTDOWN
Запрашивает услугу, чтобы выполнять задачи очистки, поскольку система отключает. Из-за чрезвычайно ограниченного времени доступного для выключения, это управление должно только использовано услугами, что совершенно нужно отключать U например, когда услуге eventlog нужно очищать грязный бит в файлы, которые это поддерживает, или когда услуге сервера нужно отключать чтобы сетевые связи не были сделаны когда система - в состоянии выключения.Если услуга берет время, чтобы отключать, и посылать сообщения статуса STOP_PENDING, она очень рекомендована, чтобы эти сообщения включали waithint чтобы диспетчер услуги узнал сколько, чтобы ожидаться прежде, чем указать в систему, которая обслуживает выключение завершенно. Система дает управляющему менеджеру услуги ограниченное время (около 20 секунд), чтобы завершать выключение услуги, после того, как какое системное выключение времени приступит независимо от того, что выключение услуги завершенно.


Обратные Величины

Эта функция не возвращает величину.

Замечания

Когда услуга Win32 запущена, функция ServiceMain должна немедленно вызывать функцию RegisterServiceCtrlHandler, чтобы определять функцию Вручителя, чтобы оперировать управляющие запросы.
Всякий раз, когда это получает управляющему запросу из управляющего менеджера услуги, управляющий диспетчер в основной резьбе процесса услуги Win32 вводит управляющую функцию вручителя для определенной услуги. После обработки управляющего запроса, управляющий вручитель должен вызвать функцию SetServiceStatus, чтобы сообщать свой текущий статус управляющему менеджеру услуги.

Смотри Также

RegisterServiceCtrlHandler, ServiceMain, SetServiceStatus


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz