The ChangeServiceConfig function changes the configuration parameters of a service.
BOOL ChangeServiceConfig(
SC_HANDLE hService, |
// handle to service |
DWORD dwServiceType, |
// type of service |
DWORD dwStartType, |
// when to start service |
DWORD dwErrorControl, |
// severity if service fails to start |
LPCTSTR lpBinaryPathName, |
// pointer to service binary file name |
LPCTSTR lpLoadOrderGroup, |
// pointer to load ordering group name |
LPDWORD lpdwTagId, |
// pointer to variable to get tag identifier |
LPCTSTR lpDependencies, |
// pointer to array of dependency names |
LPCTSTR lpServiceStartName, |
// pointer to account name of service |
LPCTSTR lpPassword, |
// pointer to password for service account |
LPCTSTR lpDisplayName |
// pointer to display name |
); |
Value |
Meaning |
SERVICE_WIN32_OWN_PROCESS |
Specifies a Win32-based service that runs in its own process. |
SERVICE_WIN32_SHARE_PROCESS |
Specifies a Win32-based service that shares a process with other services. |
SERVICE_KERNEL_DRIVER |
Specifies a driver service. |
SERVICE_FILE_SYSTEM_DRIVER |
Specifies a file system driver service. |
If you specify either SERVICE_WIN32_OWN_PROCESS or SERVICE_WIN32_SHARE_PROCESS, you can also specify the following flag.
Value |
Meaning |
SERVICE_INTERACTIVE_PROCESS |
Enables a Win32-based service process to interact with the desktop. |
Value |
Meaning |
SERVICE_BOOT_START |
Specifies a device driver started by the operating system loader. This value is valid only for driver services. |
SERVICE_SYSTEM_START |
Specifies a device driver started by the IoInitSystem function. This value is valid only for driver services. |
SERVICE_AUTO_START |
Specifies a service to be started automatically by the service control manager during system startup. |
SERVICE_DEMAND_START |
Specifies a service to be started by the service control manager when a process calls the StartService function. |
SERVICE_DISABLED |
Specifies a service that can no longer be started. |
Value |
Meaning |
SERVICE_ERROR_IGNORE |
The startup program logs the error but continues the startup operation. |
SERVICE_ERROR_NORMAL |
The startup program logs the error and puts up a message box pop-up but continues the startup operation. |
SERVICE_ERROR_SEVERE |
The startup program logs the error. If the last-known-good configuration is being started, the startup operation continues. Otherwise, the system is restarted with the last-known-good configuration. |
SERVICE_ERROR_CRITICAL |
The startup program logs the error, if possible. If the last-known-good configuration is being started, the startup operation fails. Otherwise, the system is restarted with the last-known good configuration. |
You can use a tag for ordering service startup within a load ordering group by specifying a tag order vector in the GroupOrderList value of the following registry key:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control
Tags are only evaluated for driver services that have SERVICE_BOOT_START or
SERVICE_SYSTEM_START start types.
You must prefix group names with SC_GROUP_IDENTIFIER so that they can be
distinguished from a service name, because services and service groups share
the same name space.
If the service type is SERVICE_KERNEL_DRIVER or SERVICE_FILE_SYSTEM_DRIVER,
the name is the driver object name that the system uses to load the device
driver. Specify NULL if the driver is to use a default object name created by
the I/O system.
Passwords are ignored for driver services.
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.
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_CHANGE_CONFIG access. | |
ERROR_CIRCULAR_DEPENDENCY | |
A circular service dependency was specified. | |
ERROR_DUP_NAME | |
The display name already exists in the service controller manager database, either as a service name or as another display name. | |
ERROR_INVALID_HANDLE | |
The specified handle is invalid. | |
ERROR_INVALID_PARAMETER | |
A parameter that was specified is invalid. | |
ERROR_INVALID_SERVICE_ACCOUNT | |
The account name does not exist, or a service is specified to share the same binary file as an already installed service but with an account name that is not the same as the installed service. | |
ERROR_SERVICE_MARKED_FOR_DELETE | |
The service has been marked for deletion. |
The ChangeServiceConfig function changes the configuration information for the specified service in the service control manager database. You can obtain the current configuration information by using the QueryServiceConfig function.
If the configuration is changed for a service that is running, with the exception of lpDisplayName, the changes do not take effect until the service is stopped.
The startup program uses load ordering groups to load groups of services in a specified order with respect to the other groups in the list. The list of load ordering groups is contained in the ServiceGroupOrder value of the following registry key:
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control
CreateService, OpenService, QueryServiceConfig, StartService
file: /Techref/os/win/api/win32/func/src/f04_15.htm, 16KB, , updated: 2000/4/7 12:19, local time: 2024/8/23 05:52,
18.227.46.129:LOG IN
|
©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions? <A HREF="http://piclist.com/tecHREF/os/win/api/win32/func/src/f04_15.htm"> ChangeServiceConfig</A> |
Did you find what you needed? |
![]() o List host: MIT, Site host massmind.org, Top posters @none found - Page Editors: James Newton, David Cary, and YOU! * Roman Black of Black Robotics donates from sales of Linistep stepper controller kits. * Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters. * Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated! * Contributors: Richard Seriani, Sr. |
Welcome to piclist.com! |
.