Changing a Service's Configuration

A uses the and functions to change the configuration parameters of an installed service. The program opens a handle to the service object, modifies its configuration, and then closes the service object handle.

In the following example, the DoDisableSvc function uses to change the service start type to "Disabled", the DoEnableSvc function usesChangeServiceConfig to change the service start type to "Enabled", and the DoUpdateSvcDesc function uses to set the service description to "This is a test description". The szSvcName variable is a global variable that contains the name of the service. For the complete example that sets this variable, see.

        C++ 
//// Purpose: //   Disables the service.//// Parameters://   None// // Return value://   None//VOID __stdcall DoDisableSvc(){    SC_HANDLE schSCManager;    SC_HANDLE schService;    // Get a handle to the SCM database.      schSCManager = OpenSCManager(         NULL,                    // local computer        NULL,                    // ServicesActive database         SC_MANAGER_ALL_ACCESS);  // full access rights      if (NULL == schSCManager)     {        printf("OpenSCManager failed (%d)\n", GetLastError());        return;    }    // Get a handle to the service.    schService = OpenService(         schSCManager,            // SCM database         szSvcName,               // name of service         SERVICE_CHANGE_CONFIG);  // need change config access      if (schService == NULL)    {         printf("OpenService failed (%d)\n", GetLastError());         CloseServiceHandle(schSCManager);        return;    }        // Change the service start type.    if (! ChangeServiceConfig(         schService,        // handle of service         SERVICE_NO_CHANGE, // service type: no change         SERVICE_DISABLED,  // service start type         SERVICE_NO_CHANGE, // error control: no change         NULL,              // binary path: no change         NULL,              // load order group: no change         NULL,              // tag ID: no change         NULL,              // dependencies: no change         NULL,              // account name: no change         NULL,              // password: no change         NULL) )            // display name: no change    {        printf("ChangeServiceConfig failed (%d)\n", GetLastError());     }    else printf("Service disabled successfully.\n");     CloseServiceHandle(schService);     CloseServiceHandle(schSCManager);}//// Purpose: //   Enables the service.//// Parameters://   None// // Return value://   None//VOID __stdcall DoEnableSvc(){    SC_HANDLE schSCManager;    SC_HANDLE schService;    // Get a handle to the SCM database.      schSCManager = OpenSCManager(         NULL,                    // local computer        NULL,                    // ServicesActive database         SC_MANAGER_ALL_ACCESS);  // full access rights      if (NULL == schSCManager)     {        printf("OpenSCManager failed (%d)\n", GetLastError());        return;    }    // Get a handle to the service.    schService = OpenService(         schSCManager,            // SCM database         szSvcName,               // name of service         SERVICE_CHANGE_CONFIG);  // need change config access      if (schService == NULL)    {         printf("OpenService failed (%d)\n", GetLastError());         CloseServiceHandle(schSCManager);        return;    }        // Change the service start type.    if (! ChangeServiceConfig(         schService,            // handle of service         SERVICE_NO_CHANGE,     // service type: no change         SERVICE_DEMAND_START,  // service start type         SERVICE_NO_CHANGE,     // error control: no change         NULL,                  // binary path: no change         NULL,                  // load order group: no change         NULL,                  // tag ID: no change         NULL,                  // dependencies: no change         NULL,                  // account name: no change         NULL,                  // password: no change         NULL) )                // display name: no change    {        printf("ChangeServiceConfig failed (%d)\n", GetLastError());     }    else printf("Service enabled successfully.\n");     CloseServiceHandle(schService);     CloseServiceHandle(schSCManager);}//// Purpose: //   Updates the service description to "This is a test description".//// Parameters://   None// // Return value://   None//VOID __stdcall DoUpdateSvcDesc(){    SC_HANDLE schSCManager;    SC_HANDLE schService;    SERVICE_DESCRIPTION sd;    LPTSTR szDesc = TEXT("This is a test description");    // Get a handle to the SCM database.      schSCManager = OpenSCManager(         NULL,                    // local computer        NULL,                    // ServicesActive database         SC_MANAGER_ALL_ACCESS);  // full access rights      if (NULL == schSCManager)     {        printf("OpenSCManager failed (%d)\n", GetLastError());        return;    }    // Get a handle to the service.    schService = OpenService(         schSCManager,            // SCM database         szSvcName,               // name of service         SERVICE_CHANGE_CONFIG);  // need change config access      if (schService == NULL)    {         printf("OpenService failed (%d)\n", GetLastError());         CloseServiceHandle(schSCManager);        return;    }        // Change the service description.    sd.lpDescription = szDesc;    if( !ChangeServiceConfig2(        schService,                 // handle to service        SERVICE_CONFIG_DESCRIPTION, // change: description        &sd) )                      // new description    {        printf("ChangeServiceConfig2 failed\n");    }    else printf("Service description updated successfully.\n");    CloseServiceHandle(schService);     CloseServiceHandle(schSCManager);}

Changing a Service's Configuration

Related topics