Функция ChangeServiceConfig2

Функция ChangeServiceConfig2 изменяет дополнительные параметры конфигурации службы.

Синтаксис

BOOL ChangeServiceConfig2( 
  SC_HANDLE hService,
  DWORD dwInfoLevel,
  LPVOID lpInfo 
);

Параметры

hService

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

Если одно из указанных действий диспетчера службы - SC_ACTION_RESTART, hService должен иметь право доступа SERVICE_START.

dwInfoLevel

[in] Информация о конфигурации, которая будет изменена. Этот параметр может быть одним из следующих значений.

Значение	Предназначение
SERVICE_CONFIG_DESCRIPTION	Параметр *lpInfo* - указатель на структуру SERVICE_DESCRIPTION.
SERVICE_CONFIG_FAILURE_ACTIONS	Параметр *lpInfo* - указатель на структуру SERVICE_FAILURE_ACTIONS. Если Вы задаете в параметре SC_ACTION_REBOOT, вызывающая программа должна иметь привилегию SE_SHUTDOWN_NAME. Дополнительную информацию смотри в статье Запуск со специальными привилегиями.

Значение

Предназначение

SERVICE_CONFIG_DESCRIPTION

Параметр lpInfo - указатель на структуру SERVICE_DESCRIPTION.

SERVICE_CONFIG_FAILURE_ACTIONS

Параметр lpInfo - указатель на структуру SERVICE_FAILURE_ACTIONS.

Если Вы задаете в параметре SC_ACTION_REBOOT, вызывающая программа должна иметь привилегию SE_SHUTDOWN_NAME. Дополнительную информацию смотри в статье Запуск со специальными привилегиями.

lpInfo

[in] Указатель на новое значение, которое будет установлено для информации о конфигурации. Формат этих данных зависит от значения параметра dwInfoLevel. Если это значение - значение ПУСТО (NULL), информация остается неизменной.

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

Если функция завершается ошибкой, возвращаемое значение является ненулевым.

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

Замечания

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

Вы не можете установить значение SERVICE_CONFIG_FAILURE_ACTIONS для службы, которая совместно использует процесс диспетчера управления службами. Это включает в себя все службы, исполняемый загрузочный модуль которых - "services.exe".

Вы можете изменить и сделать запрос дополнительной информации о конфигурации, используя функции ChangeServiceConfig и QueryServiceConfig, соответственно.

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

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

Смотри также

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

Размещение и совместимость ChangeServiceConfig2
К	Windows XP	Да
л	Windows 2000 Professional	Да
и	Windows NT	Нет
е	Windows Me	Нет
н	Windows 98	Нет
т	Windows 95	Нет

С	Windows Server 2003	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Нет
в
е
р
Используемая библиотека		Advapi32.lib
Используемая DLL		advapi32.dll
Заголовочный файл
- объявлено в		Winsvc.h
- включено в		Windows.h
Unicode		Реализуется как ChangeServiceConfig2W (Unicode) и ChangeServiceConfig2A (ANSI).
Замечания по платформе		Не имеется

Назад в оглавление

На главную страницу

В оглавление справки