|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
EnumDependentServices
The EnumDependentServices function enumerates services that depend on another specified service; that is, the specified service must be running before the enumerated services can run. The name and status of each dependent service are provided.
BOOL EnumDependentServices(
SC_HANDLE hService, // handle to service DWORD dwServiceState, // state of services to enumerate LPENUM_SERVICE_STATUS lpServices, // pointer to service status buffer DWORD cbBufSize, // size of service status buffer LPDWORD pcbBytesNeeded, // pointer to variable for bytes needed LPDWORD lpServicesReturned // pointer to variable for number returned );
Parameters
hService
Handle that identifies the service. This handle is returned by the OpenService or CreateService function, and it must have SERVICE_ENUMERATE_DEPENDENTS access.
dwServiceState
Specifies the services to enumerate based on their running state. It must be one or both of the following values:
Value Meaning SERVICE_ACTIVE Enumerates services that are in the following states: SERVICE_START_PENDING, SERVICE_STOP_PENDING, SERVICE_RUNNING, SERVICE_CONTINUE_PENDING, SERVICE_PAUSE_PENDING, and SERVICE_PAUSED. SERVICE_INACTIVE Enumerates services that are in the SERVICE_STOPPED state.
lpServices
Pointer to an array of ENUM_SERVICE_STATUS structures. Each structure receives name and service status information for a dependent service. The order of the services in this array is the reverse of the start order of the services. In other words, the first dependent service in the array is the one that would be started last, and the last service in the array is the one that would be started first.
cbBufSize
Specifies the size, in bytes, of the buffer pointed to by the lpServices parameter.
pcbBytesNeeded
Pointer to a variable that receives the number of bytes needed to store the array of service entries. The variable only receives this value if the buffer pointed to by lpServices is too small, indicated by function failure and the ERROR_MORE_DATA error; otherwise, the contents of *pcbBytesNeeded are undefined.
lpServicesReturned
Pointer to a variable that receives the number of service entries 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_ENUMERATE_DEPENDENTS access. ERROR_INVALID_HANDLE The specified handle is invalid. ERROR_INVALID_PARAMETER A parameter that was specified is invalid. ERROR_MORE_DATA The buffer pointed to by lpServices is not large enough. The function sets the variable pointed to by lpServicesReturned to the actual number of service entries stored into the buffer. The function sets the variable pointed to by pcbBytesNeeded to the number of bytes required to store all of the service entries.
Remarks
The returned services entries are ordered in the reverse order of the start order, with group order taken into account. If you need to stop the dependent services, you can use the order of entries written to the lpServices buffer to stop the dependent services in the proper order.
See Also
CreateService, ENUM_SERVICE_STATUS, EnumServicesStatus, OpenService
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
EnumDependentServices
Функция EnumDependentServices перечисляет услуги, которые зависят от другого определившее услугу; то есть, определенная услуга должна работать прежде, чем перечисленные услуги могут работать. Имя и статус каждой зависимой услуги предусмотрены.
BOOL EnumDependentServices(
SC_HANDLE hService, // ручка, чтобы обслуживать DWORD dwServiceState, // состояние услуг, чтобы перечислять LPENUM_SERVICE_STATUS lpServices, // указатель, чтобы обслуживать буфер статуса DWORD cbBufSize, // размера буфера статуса услуги LPDWORD pcbBytesNeeded, // указатель в переменную для нужно байтов LPDWORD lpServicesReturned // указатель в переменную для числа возвращанного );
Параметры
hService
Ручка, что идентифицирует услугу. Эта ручка возвращана OpenService или функцией CreateService, и это должно иметь доступ SERVICE_ENUMERATE_DEPENDENTS.
dwServiceState
Определяет услуги, чтобы перечислять базирующийся в их прогоне состояния. Это должно быть один или оба следующих величин:
Значение Величины SERVICE_ACTIVE Перечисляет услуги, которые - в следующем состояний: SERVICE_START_PENDING, SERVICE_STOP_PENDING, SERVICE_RUNNING, SERVICE_CONTINUE_PENDING, SERVICE_PAUSE_PENDING, и SERVICE_PAUSED. SERVICE_INACTIVE Перечисляет услуги, которые - в состоянии SERVICE_STOPPED.
lpServices
Указатель в массив структур ENUM_SERVICE_STATUS. Каждая структура получает имя и информацию статуса услуги для зависимой услуги. Порядок услуг в этом массиве противоположный стартовому порядку услуг. Другими словами, первая зависимая услуга в массиве - то которая должна быть запущена последним, и последняя услуга в массиве - то которая должна запускаться сначала.
cbBufSize
Определяет размер, в байтах, буфера указанного, чтобы параметром lpServices.
pcbBytesNeeded
Указатель в переменную, которая получает количество нужно байтов, чтобы загружать массив данных услуги. Переменная только получает эту величину если буфер указанный, чтобы lpServices - слишком небольшой, указанный функциональной неудачей и ошибка ERROR_MORE_DATA; в противном случае, содержание *pcbBytesNeeded неопределенные.
lpServicesReturned
Указатель в переменную, которая получает номер данных услуги возвращался.
Обратные Величины
Если функция добивается успеха, обратная величина ненулевая. Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.
Ошибки
Следующие коды ошибки могут быть установлены управляющим менеджером услуги. Другие коды ошибки могут быть установлены функциями регистрации, что названы управляющим менеджером услуги.
Оцените Значение ERROR_ACCESS_DENIED Определенная ручка не была открыта доступом SERVICE_ENUMERATE_DEPENDENTS. ERROR_INVALID_HANDLE определенная ручка недействительна. ERROR_INVALID_PARAMETER параметр, который был определен, недействительно. ERROR_MORE_DATA Буфер указанный, чтобы lpServices - не большой достаточно. Функция устанавливает переменную указанную, чтобы lpServicesReturned в фактический номер данных услуги загруженной в буфер. Функция устанавливает переменную указанную, чтобы pcbBytesNeeded в количество байтов требовавшихся, чтобы загружать все данные услуги.
Замечания
Возвращанные данные услуг заказаны в обратный порядок стартового порядка, с групповым порядком принявшим во внимание. Если Вам нужно останавливать зависимые услуги, Вы можете использовать порядок данных записанных в буфер lpServices, чтобы останавливать зависимые услуги в соответствующем порядке.
Смотри Также
CreateService, ENUM_SERVICE_STATUS, EnumServicesStatus, OpenService
|
|
|
|
| |