На главную

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 | Скачать Вниз

RegisterServiceCtrlHandler



The RegisterServiceCtrlHandler function registers a function to handle service control requests for a service.

SERVICE_STATUS_HANDLE RegisterServiceCtrlHandler(

LPCTSTR lpServiceName, // address of name of service
LPHANDLER_FUNCTION lpHandlerProc // address of handler function
);


Parameters

lpServiceName

Points to a null-terminated string that names the service run by the calling thread. This is the service name that was specified in the CreateService function when the service was created.

lpHandlerProc

Points to the Handler function to be registered.



Return Values

If the function succeeds, the return value is a service status handle.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Errors

The following error codes may be set by the service control manager. Other error codes may be set by the registry functions that are called by the service control manager.

Value Meaning
ERROR_INVALID_NAME The specified service name is invalid.
ERROR_SERVICE_DOES_NOT_EXIST The specified service does not exist.


Remarks

The ServiceMain function of a new service should immediately call the RegisterServiceCtrlHandler function to register a control handling function with the control dispatcher. This enables the control dispatcher to invoke the specified function when it receives control requests for this service. The threads of the calling process can use the service status handle returned by this function to identify the service in subsequent calls to the SetServiceStatus function.

This function must be called before the first SetServiceStatus call because it returns a service status handle for the caller to use so that no other service can inadvertently set this service's status, which is maintained by the service control manager. It also needs to be called before the first SetServiceStatus so that a control handler is in place to field control requests by the time the service specifies the controls it accepts through the SetServiceStatus function.

When the control handler function is invoked with a control request, it must call SetServiceStatus to notify the service control manager of its latest status, regardless of whether the status of the service has changed.
The service status handle does not have to be closed.

See Also

CreateService, Handler, ServiceMain, SetServiceStatus




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

RegisterServiceCtrlHandler



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

SERVICE_STATUS_HANDLE RegisterServiceCtrlHandler(

LPCTSTR lpServiceName, // АДРЕС имени адреса услуги LPHANDLER_FUNCTION lpHandlerProc // функции вручителя
);


Параметры

lpServiceName

Точки на недействительный расторгнутую строку, которые называют руководить услуги вызовом резьбы. Это - имя услуги, которое было определено в функции CreateService когда услуга была создана.

lpHandlerProc

Точки на функцию Вручителя, чтобы быть зарегистрированн.



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

Если функция добивается успеха, обратная величина является ручкой статуса услуги.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Ошибки

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

Значение Величины
ERROR_INVALID_NAME определенное имя услуги недействительно.
ERROR_SERVICE_DOES_NOT_EXIST определенная услуга не существует.


Замечания

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

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

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

Смотри Также

CreateService, Handler, ServiceMain, SetServiceStatus




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