Функция 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. Дополнительную информацию смотри в статье Запуск со специальными привилегиями.

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).

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz