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 | Скачать

QueryServiceStatus

The QueryServiceStatus function retrieves the current status of the specified service.

BOOL QueryServiceStatus(

SC_HANDLE hService, // handle of service
LPSERVICE_STATUS lpServiceStatus // address of service status structure
);

Parameters

hService

Identifies the service. This handle is returned by the OpenService or the CreateService function, and it must have SERVICE_QUERY_STATUS access.

lpServiceStatus

Points to a SERVICE_STATUS structure in which the status information is returned.

Return Values

If the function succeeds, the return value is nonzero.
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_ACCESS_DENIED The specified handle was not opened with SERVICE_QUERY_STATUS access.
ERROR_INVALID_HANDLE The specified handle is invalid.

Remarks

The QueryServiceStatus function returns the most recent service status information reported to the service control manager. The service may have just changed its status and may not have updated the service control manager yet. Applications can find out the absolutely latest service status by interrogating the service directly by using the ControlService function with the SERVICE_CONTROL_INTERROGATE control code.

See Also

ControlService, CreateService, OpenService, SERVICE_STATUS, SetServiceStatus

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

QueryServiceStatus

Функция QueryServiceStatus извлекает текущий статус определенной услуги.

BOOL QueryServiceStatus(

SC_HANDLE hService, // ручка адреса услуги LPSERVICE_STATUS lpServiceStatus // структуры статуса услуги
);

Параметры

hService

Идентифицирует услугу. Эта ручка возвращана OpenService или функцией CreateService, и это должно иметь доступ SERVICE_QUERY_STATUS.

lpServiceStatus

Точки на структуру SERVICE_STATUS в которых информация статуса возвращана.

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

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

Ошибки

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

Значение Величины
ERROR_ACCESS_DENIED определенная ручка не была открыта доступом SERVICE_QUERY_STATUS.
ERROR_INVALID_HANDLE определенная ручка недействительна.

Замечания

Функция QueryServiceStatus возвращает наиболее информацию статуса последней услуги сообщенную управляющему менеджеру услуги. Услуга может просто изменить свой статус и не может корректировала управляющего менеджера услуги пока. Приложения могут обнаружить совершенно самый последний статус услуги опрашивая услугу непосредственно используя функцию ControlService с управляющим кодом SERVICE_CONTROL_INTERROGATE.

Смотри Также

ControlService, CreateService, OpenService, SERVICE_STATUS, SetServiceStatus

Используются технологии uCoz