Функция ChangeServiceConfig2 изменяет дополнительные параметры конфигурации службы.
Синтаксис
BOOL ChangeServiceConfig2( SC_HANDLE hService, DWORD dwInfoLevel, LPVOID lpInfo ); |
Параметры
Если одно из указанных действий диспетчера службы - SC_ACTION_RESTART, hService должен иметь право доступа SERVICE_START.
Значение | Предназначение |
---|---|
SERVICE_CONFIG_DESCRIPTION | Параметр lpInfo - указатель на структуру SERVICE_DESCRIPTION. |
SERVICE_CONFIG_FAILURE_ACTIONS | Параметр lpInfo -
указатель на структуру SERVICE_FAILURE_ACTIONS.
Если Вы задаете в параметре SC_ACTION_REBOOT, вызывающая программа должна иметь привилегию SE_SHUTDOWN_NAME. Дополнительную информацию смотри в статье Запуск со специальными привилегиями. |
Если функция завершается ошибкой, возвращаемое значение является ненулевым.
Если функция завершается ошибкой, возвращаемое значение - нуль. Чтобы получить дополнительную информацию об ошибке, вызовите 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). |
|
Замечания по платформе |
Не имеется |