[This function is available for use in the operating systems indicated in the
Requirements section. It may be altered or unavailable in subsequent versions. SetupAPI should no longer be used
for installing applications. Instead, use the Windows Installer for developing application installers. SetupAPI
continues to be used for installing device drivers.]
function performs service installation and deletion operations that are specified in the
Service Install sections listed in the Service section of
an INF file.
A caller of this function is required to have access to the
Service Control Manager, and privileges to modify
A handle to the INF file that contains the Service section.
The name of the Service section to process. You should use a null-terminated
The controls for the installation of each service in the specified section.
AddService section: move the service tag to the front of its group order list.
DelService section: delete the event log entry.
AddService section: do not overwrite the display name if one already exists.
AddService section: do not overwrite the start type value if the service already exists.
AddService section: do not overwrite the error control value if the service already exists.
AddService section: do not overwrite the load order group if it already exists.
AddService section: do not overwrite the dependencies list if it already exists.
AddService section: mark this service as the function driver for the device being installed.
DelService section: Stop the associated service specified in the entry before deleting the service.
AddService section: Security settings the service are overwritten if the service already exists in the
Note Available starting with Windows Server 2003 and Windows XP.
AddService section: Start the service after the service is installed. This flag cannot be used to start a
service that implements a Plug and Play (PnP) function driver or filter driver for a device. Otherwise,
this flag can be used to start a user-mode or kernel-mode service that is managed by the Service Control
Note Available starting with Windows Server 2008 and Windows Vista.
AddService section: Do not overwrite the given service's required privileges if the service already exists
in the system.
Note Available starting with Windows Server 2008 R2 and Windows 7.
If the function succeeds, the return value is nonzero. The function calls
SetLastError with ERROR_SUCCESS_REBOOT_REQUIRED if a reboot of the system is
If the function fails, the return value is 0 (zero). To get extended error information, call