Функция QueryServiceConfig

Функция QueryServiceConfig извлекает параметры конфигурации указанной службы. Дополнительные параметры конфигурации - разрешает использовать функция QueryServiceConfig2.

Синтаксис

Параметры

hService

[in] Дескриптор службы. Этот дескриптор возвращается функцией OpenService или CreateService и должен иметь право доступа SERVICE_QUERY_CONFIG. Дополнительную информацию смотри в статье Защита службы и права доступа.

lpServiceConfig

[out] Указатель на буфер, который получает информацию о конфигурации службы. Формат данных - это структура QUERY_SERVICE_CONFIG.

Максимальный размер этого массива - 8 КБ. Чтобы определять необходимый размер, задайте значение ПУСТО (NULL) для этого параметра и 0 для параметра cbBufSize. Функция завершится ошибкой, а GetLastError возвратит значение ERROR_INSUFFICIENT_BUFFER. Параметр pcbBytesNeeded получит необходимый размер.

cbBufSize

[in] Размер буфера, на который указывает параметр lpServiceConfig, в байтах.

pcbBytesNeeded

[out] Указатель на переменную, которая получает число байтов, необходимых для сохранения всей информации о конфигурации, если функция завершается ошибкой со значением ERROR_INSUFFICIENT_BUFFER.

Возвращаемые значения

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

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

Замечания

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

Если служба была запущена, когда информация о конфигурации была последний раз изменена, то информация, возвращенная функцией QueryServiceConfig не будет отражать текущую конфигурацию службы. Вместо этого она отразит конфигурацию службы, периода запуска. Ключ DisplayName - исключение для этого. Когда ключ DisplayName изменяется, то он вступает в силу немедленно, независимо от того, запускается ли служба.

Демонстрационный код

Пример смотри в статье Запрос конфигурации службы.

Смотри также

Обзор Службы, Функции, используемые службами, ChangeServiceConfig, CreateService, OpenService, QueryServiceConfig2, QueryServiceObjectSecurity, QUERY_SERVICE_CONFIG