Desktop Functions:

   Smart Device Functions:

Show Recent Changes
Subscribe (RSS)
Misc. Pages
Helpful Tools
Suggested Reading
Website TODO List
Support Forum
Download Visual Studio Add-In

Terms of Use
Privacy Policy
ChangeServiceConfig (advapi32)
Changes the optional configuration parameters of a service.

C# Signature:

    [DllImport("advapi32.dll", SetLastError=true, CharSet=CharSet.Auto)]
    [return: MarshalAs(UnmanagedType.Bool)]
    public static extern bool ChangeServiceConfig2(
        IntPtr hService,
        int dwInfoLevel,
        IntPtr lpInfo);

Better C# Signature:

    [DllImport("advapi32.dll", EntryPoint = "ChangeServiceConfig")]
    [return: MarshalAs(UnmanagedType.Bool)]
    public static extern bool ChangeServiceConfigA(IntPtr hService, uint dwServiceType,
    int dwStartType, int dwErrorControl, string lpBinaryPathName, string lpLoadOrderGroup,
    string lpdwTagId, string lpDependencies, string lpServiceStartName, string lpPassword,
    string lpDisplayName);

VB Signature:

Declare Function ChangeServiceConfig2 Lib "advapi32.dll" (TODO) As TODO

User-Defined Types:

See SERVICE_FAILURE_ACTIONS structure as one possible value for lpInfo.

Alternative Managed API:

Most (but not all) functionality can be accessed using classes in the System.ServiceProcess namespace..


See or for details on how to call ChangeServiceConfig2.

Values for dwInfoLevel determine what structures are using for lpInfo. The possible values for this parameter can be found in WinSvc.h in the platform SDK.


Not all are suported in all Windows versions see details:

Tips & Tricks:

To open service you don't need to use Windows API (OpenSCManager() and OpenService()) use field of System.ServiceProcess.ServiceController class (ServiceController.ServiceHandle.DangerousGetHandle())

Sample Code:

    public MyServiceInstaller()
        serviceInstaller1.Committed += new InstallEventHandler(serviceInstaller1_Committed);

    void serviceInstaller1_Committed(object sender, InstallEventArgs e)
        IntPtr scHandle = IntPtr.Zero;
        IntPtr svcHandle = IntPtr.Zero;
        string serviceName = "MyService";

        scHandle = OpenSCManager(null, null, (uint)SCM_ACCESS.SC_MANAGER_ALL_ACCESS);
        if (scHandle == IntPtr.Zero)
            throw new Exception(String.Format("Error connecting to Service Control Manager. Error provided was: 0x{0:X}", Marshal.GetLastWin32Error()));

        svcHandle = OpenService(scHandle, serviceName, (int)SERVICE_ACCESS.SERVICE_ALL_ACCESS);
        if (svcHandle == IntPtr.Zero)
            throw new Exception(String.Format("Error opening service for modifying. Error returned was: 0x{0:X}", Marshal.GetLastWin32Error()));

        SC_ACTION action = new SC_ACTION();
        action.Type = SC_ACTION_RESTART;
        action.Delay = (int)TimeSpan.FromMinutes(1).TotalMilliseconds;

        IntPtr lpsaActions = Marshal.AllocHGlobal(Marshal.SizeOf(action) * 2);
        if (lpsaActions == IntPtr.Zero)
            throw new Exception(String.Format("Unable to allocate memory for service action, error was: 0x{0:X}", Marshal.GetLastWin32Error()));

        Marshal.StructureToPtr(action, lpsaActions, false);

        IntPtr nextAction = (IntPtr)(lpsaActions.ToInt64() + Marshal.SizeOf(action));
        action.Type = SC_ACTION_NONE;

        Marshal.StructureToPtr(action, nextAction, false);

        failureActions.dwResetPeriod = (int)TimeSpan.FromDays(1).TotalSeconds;
        failureActions.lpRebootMsg = "";
        failureActions.lpCommand = "";
        failureActions.cActions = 2;
        failureActions.lpsaActions = lpsaActions;

        IntPtr lpInfo = Marshal.AllocHGlobal(Marshal.SizeOf(failureActions));
        if (lpInfo == IntPtr.Zero)
            throw new Exception(String.Format("Unable to allocate memory, error was: 0x{0:X}", Marshal.GetLastWin32Error()));

        Marshal.StructureToPtr(failureActions, lpInfo, false);

        if (!ChangeServiceConfig2(svcHandle, SERVICE_CONFIG_FAILURE_ACTIONS, lpInfo))
            throw new Exception(String.Format("Error setting service config, error was: 0x{0:X}", Marshal.GetLastWin32Error()));


        EventLog.WriteEntry("MyService", "Service modification completed");
        catch (Exception ex)
        EventLog.WriteEntry("MyService", ex.Message);

        // Make sure to close open handles
        if (svcHandle != IntPtr.Zero)

        if (scHandle != IntPtr.Zero)


Please edit this page!

Do you have...

  • helpful tips or sample code to share for using this API in managed code?
  • corrections to the existing content?
  • variations of the signature you want to share?
  • additional languages you want to include?

Select "Edit This Page" on the right hand toolbar and edit it! Or add new pages containing supporting types needed for this API (structures, delegates, and more).

Access directly from VS:
Terms of Use
Edit This Page
Find References
Show Printable Version