ChangeStartMode method of the Win32_Service class (CIMWin32 WMI Providers)

Article
01/06/2021

The ChangeStartMode WMI class method modifies the start mode of a Win32_Service.

This topic uses Managed Object Format (MOF) syntax. For more information about using this method, see Calling a Method.

Syntax

uint32 ChangeStartMode(
  [in] string StartMode = Auto Start
);

Parameters

StartMode [in]: Start mode of the Windows base service.
Boot Start ("Boot"): Device driver started by the operating system loader. This value is valid only for driver services.
System ("System"): Device driver started by the operating system initialization process. This value is valid only for driver services.
Auto Start ("Automatic"): Service to be started automatically by the service control manager during system startup.
Demand Start ("Manual"): Service to be started by the service control manager when a process calls the StartService method.
Disabled ("Disabled"): Service that can no longer be started.

Return value

Returns one of the values listed in the following list or any other value to indicate an error. For additional error codes, see WMI Error Constants or WbemErrorEnum. For general HRESULT values, see System Error Codes.

Success

The request was accepted.

Not Supported

The request is not supported.

Access Denied

The user did not have the necessary access.

Dependent Services Running

The service cannot be stopped because other services that are running are dependent on it.

Invalid Service Control

The requested control code is not valid, or it is unacceptable to the service.

Service Cannot Accept Control

The requested control code cannot be sent to the service because the state of the service (Win32_BaseService.State property) is equal to 0, 1, or 2.

Service Not Active

The service has not been started.

Service Request Timeout

The service did not respond to the start request in a timely fashion.

Unknown Failure

Unknown failure when starting the service.

Path Not Found

The directory path to the service executable file was not found.

Service Already Running

The service is already running.

Service Database Locked

The database to add a new service is locked.

Service Dependency Deleted

A dependency this service relies on has been removed from the system.

Service Dependency Failure

The service failed to find the service needed from a dependent service.

Service Disabled

The service has been disabled from the system.

Service Logon Failed

The service does not have the correct authentication to run on the system.

Service Marked For Deletion

This service is being removed from the system.

Service No Thread

The service has no execution thread.

Status Circular Dependency

The service has circular dependencies when it starts.

Status Duplicate Name

A service is running under the same name.

Status Invalid Name

The service name has invalid characters.

Status Invalid Parameter

Invalid parameters have been passed to the service.

Status Invalid Service Account

The account under which this service runs is either invalid or lacks the permissions to run the service.

Status Service Exists

The service exists in the database of services available from the system.

Service Already Paused

The service is currently paused in the system.

Other

25 4294967295

Examples

The following Change StartMode of a Service PowerShell sample changes the start mode of a service.

$wmi = get-wmiobject -class win32_service -namespace root\cimv2 -computername lisbon | 
where-object { $_.name -eq 'bits' } 
 
$rtn = $wmi.changestartmode("manual") 
if($rtn.returnvalue -eq 0) { "success" } 
ELSE 
  { " $($rtn.returnvalue) was reported" }

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll