The Win32_BaseService class represents executable objects that are installed in a registry database maintained by the Service Control Manager. The executable file associated with a service can be started at boot time by a boot program or by the system. It can also be started on-demand by the Service Control Manager. Any service or process that is not owned by a specific user, and that provides an interface to some functionality supported by the computer system, is a descendent (or member) of this class.
Example: The dynamic host configuration protocol (DHCP) client service on a Windows NT/Windows 2000 computer system.
Win32_BaseService - child subclasses in ROOT\MicrosoftIISv2\MS_409
{'Description':'The DisplayName parameter passes the display name of the service. This string has a maximum length of 256 characters. The name is case-preserved in the service control manager. DisplayName comparisons are always case-insensitive. Constraints: Accepts the same value as the Name parameter.Example: Atdisk','In':True}
PathName
string
1
✓
-
{'Description':'The PathName parameter passes the fully qualified path of the service binary file that implements the service.Example: \SystemRoot\System32\drivers\afd.sys','In':True}
ServiceType
uint8
2
✓
-
{'BitValues':['Kernel Driver', 'File System Driver', 'Adapter', 'Recognizer Driver', 'Own Process', 'Share Process'],'Description':'The ServiceType parameter passes the type of service provided to processes calling the service.','In':True}
ErrorControl
uint8
3
✓
-
{'Description':'If this service fails to start during startup, the ErrorControl parameter passes the severity of the error. The value indicates the action taken by the startup program if failure occurs. All errors are logged by the system. The system does not notify the user of "Ignore" errors. With "Normal" errors the user is notified. With "Severe" errors, the system is restarted with the last-known-good configuration. Finally, on "Critical" errors, the system attempts to restart with a good configuration.','In':True,'Values':['Ignore', 'Normal', 'Severe', 'Critical']}
StartMode
string
4
✓
-
{'Description':'The StartMode property indicates the start mode of the Win32 base service. "Boot" specifies a device driver started by the operating system loader. This value is valid only for driver services. "System" specifies a device driver started by the IoInitSystem function. This value is valid only for driver services. "Automatic" specifies a service to be started automatically by the service control manager during system startup. "Manual" specifies a service to be started by the service control manager when a process calls the StartService function. "Disabled" specifies a service that can no longer be started.','In':True,'Values':['Boot Start', 'System Start', 'Auto Start', 'Demand Start', 'Disabled']}
DesktopInteract
boolean
5
✓
-
{'Description':'The DesktopInteract parameter passes the value that indicates whether the service can create or communicate with windows on the desktop.Values: TRUE or FALSE. A value of TRUE indicates the service can create or communicate with windows on the desktop.','In':True}
StartName
string
6
✓
-
{'Description':'The StartName property indicates the account name the service runs under. Depending on the service type, the account name may be in the form of "DomainName\Username", The service process will be logged using one of these two forms when it runs. If the account belongs to the built-in domain, ".\Username" can be specified. If NULL is specified, the service will be logged on as the LocalSystem account. For kernel or system-level drivers, StartName contains the driver object name (that is, \FileSystem\Rdr or \Driver\Xns) that the input and output (I/O) system uses to load the device driver. If NULL is specified, the driver runs with a default object name created by the I/O system based on the service name.Example: DWDOM\Admin.','In':True}
StartPassword
string
7
✓
-
{'Description':'The StartPassword parameter passes the password to the account name specified by the StartName parameter. Specify NULL if you are not changing the password. Specify an empty string if the service has no password.','In':True}
LoadOrderGroup
string
8
✓
-
{'Description':'The LoadOrderGroup parameter passes the group name that it is associated with. Load order groups are contained in the system registry, and determine the sequence in which services are loaded into the operating system. If the pointer is NULL, or if it points to an empty string, the service does not belong to a group. Dependencies between groups should be listed in the LoadOrderGroupDependencies parameter. Services in the load-ordering group list are started first, followed by services in groups not in the load-ordering group list, followed by services that do not belong to a group. The system registry has a list of load ordering groups located at:HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ServiceGroupOrder.','In':True}
LoadOrderGroupDependencies
string
9
✓
-
{'Description':'The LoadOrderGroupDependencies parameter passes a list of load ordering groups that must start before this service starts. The array is doubly null-terminated. If the pointer is NULL, or if it points to an empty string, the service has no dependencies. Group names must be prefixed by the SC_GROUP_IDENTIFIER (defined in the WINSVC.H file) character to differentiate them from service names because services and service groups share the same name space. Dependency on a group means that this service can run if at least one member of the group is running after an attempt to start all members of the group.','In':True}
ServiceDependencies
string
10
✓
-
{'Description':'The ServiceDependencies parameter passes a list containing names of services that must start before this service starts. The array is doubly null-terminated. If the pointer is NULL, or if it points to an empty string, the service has no dependencies. Dependency on a service means that this service can run only if the service it depends on is running.','In':True}
Description
'The Change method modifies a service. It returns an integer value of 0 if the service was successfully modified, 1 if the request is not supported and any other number to indicate an error. The Win32_LoadOrderGroup parameter represents a grouping of system services defining execution dependencies. The services must be initiated in the order specified by the Load Order Group as the services are dependent on each other. These dependent services require the presence of the antecedent services in order to function correctly.'
{'Description':'The StartMode parameter passes the start mode of the Win32 base service. "Boot" specifies a device driver started by the operating system loader. This value is valid only for driver services. "System" specifies a device driver started by the IoInitSystem function. This value is valid only for driver services. "Automatic" specifies a service to be started automatically by the service control manager during system startup. "Manual" specifies a service to be started by the service control manager when a process calls the StartService function. "Disabled" specifies a service that can no longer be started.','In':True,'Values':['Boot Start', 'System Start', 'Auto Start', 'Demand Start', 'Disabled']}
Description
'The ChangeStartMode method modifies the StartMode of a service. It returns an integer value of 0 if the service was successfully modified, 1 if the request is not supported, and any other number to indicate an error.'
{'Description':'The Name parameter passes the name of the service to install to the Create method. The maximum string length is 256 characters. The service control manager database preserves the case of the characters, but service name comparisons are always case insensitive. Forward-slashes (/) and double back-slashes (\) are invalid service name characters.','In':True}
DisplayName
string
1
✓
-
{'Description':'The DisplayName parameter passes the display name of the service. This string has a maximum length of 256 characters. The name is case-preserved in the service control manager. DisplayName comparisons are always case-insensitive. Constraints: Accepts the same value as the Name parameter.Example: Atdisk.','In':True}
PathName
string
2
✓
-
{'Description':'The PathName parameter passes the fully qualified path to the executable file that implements the service.Example: \SystemRoot\System32\drivers\afd.sys','In':True}
ServiceType
uint8
3
✓
-
{'BitValues':['Kernel Driver', 'File System Driver', 'Adapter', 'Recognizer Driver', 'Own Process', 'Share Process'],'Description':'The ServiceType parameter passes the type of services provided to processes that call them.','In':True}
ErrorControl
uint8
4
✓
-
{'Description':'If the Create method fails to start, the ErrorControl parameter passes the severity of the error. The value indicates the action taken by the startup program if failure occurs. All errors are logged by the system. The system does not notify the user of "Ignore" errors. With "Normal" errors the user is notified. With "Severe" errors, the system is restarted with the last-known-good configuration. Finally, on "Critical" errors, the system attempts to restart with a good configuration.','In':True,'Values':['Ignore', 'Normal', 'Severe', 'Critical']}
StartMode
string
5
✓
-
{'Description':'The StartMode parameter passes the start mode of the Win32 base service. "Boot" specifies a device driver started by the operating system loader. This value is valid only for driver services. "System" specifies a device driver started by the IoInitSystem function. This value is valid only for driver services. "Automatic" specifies a service to be started automatically by the service control manager during system startup. "Manual" specifies a service to be started by the service control manager when a process calls the StartService function. "Disabled" specifies a service that can no longer be started.','In':True,'Values':['Boot Start', 'System Start', 'Auto Start', 'Demand Start', 'Disabled']}
DesktopInteract
boolean
6
✓
-
{'Description':'The DesktopInteract parameter passes the value that indicates whether the service can create or communicate with windows on the desktop.Values: TRUE or FALSE. A value of TRUE indicates the service can create or communicate with windows on the desktop.','In':True}
StartName
string
7
✓
-
{'Description':'The StartName parameter passes the account name the service runs under. Depending on the service type, the account name may be in the form of "DomainName\Username".The service process will be logged using one of these two forms when it runs. If the account belongs to the built-in domain, ".\Username" can be specified. If NULL is specified, the service will be logged on as the LocalSystem account. For a kernel or system-level drivers, StartName contains the driver object name (that is, \FileSystem\Rdr or \Driver\Xns) which the input and output (I/O) system uses to load the device driver. If NULL is specified, the driver runs with a default object name created by the I/O system based on the service name.Example: DWDOM\Admin.','In':True}
StartPassword
string
8
✓
-
{'Description':'The StartPassword parameter passes the password to the account name specified by the StartName parameter. Specify NULL if you are not changing the password. Specify an empty string if the service has no password.','In':True}
LoadOrderGroup
string
9
✓
-
{'Description':'The LoadOrderGroup parameter passes the group name associated with the new service. Load order groups are contained in the registry, and determine the sequence in which services are loaded into the operating system. If the pointer is NULL or if it points to an empty string, the service does not belong to a group. Dependencies between groups should be listed in the LoadOrderGroupDependencies parameter. Services in the load-ordering group list are started first, followed by services in groups not in the load-ordering group list, followed by services that do not belong to a group. The registry has a list of load ordering groups located at:HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ServiceGroupOrder.','In':True}
LoadOrderGroupDependencies
string
10
✓
-
{'Description':'The LoadOrderGroupDependencies parameter passes a list of load ordering groups that must start before this service. The array is doubly null-terminated. If the pointer is NULL or if it points to an empty string, the service has no dependencies. Group names must be prefixed by the SC_GROUP_IDENTIFIER (defined in the WINSVC.H file) character to differentiate it from a service name, because services and service groups share the same name space. Dependency on a group means that this service can run if at least one member of the group is running after an attempt to start all members of the group.','In':True}
ServiceDependencies
string
11
✓
-
{'Description':'The ServiceDependencies parameter passes a list containing names of services that must start before this service starts. The array is doubly null-terminated. If the pointer is NULL, or if it points to an empty string, the service has no dependencies. Dependency on a service means that this service can only run if the service it depends on is running.','In':True}
Description
'The Create method creates a new service. It returns an integer value of 0 if the service was successfully created, 1 if the request is not supported, and any other number to indicate an error. The Win32_LoadOrderGroup parameter represents a grouping of system services defining execution dependencies. The services must be initiated in the order specified by the Load Order Group, as the services are dependent on each other. These dependent services require the presence of the antecedent services in order to function correctly.'
'The Delete method deletes an existing service. It returns an integer value of 0 if the service was successfully deleted, 1 if the request is not supported, and any other number to indicate an error.'
'The InterrogateService method requests that the service update its state to the service manager. It returns an integer value of 0 if the InterrogateService request was accepted, 1 if the request is not supported, and any other number to indicate an error.'
'The PauseService method attempts to place the service in the paused state. It returns an integer value of 0 if the PauseService request was accepted, 1 if the request is not supported, and any other number to indicate an error.'
'The ResumeService method attempts to place the service in the resumed state. It returns an integer value of 0 if the ResumeService request was accepted, 1 if the request is not supported, and any other number to indicate an error.'
{'Description':'The ControlCode parameter specifies defined values(from 128 to 255) that provide control commands specific to a user.','In':True}
Description
'The UserControlService method attempts to send a user-defined control code to a service. It returns an integer value of 0 if the UserControlService request was accepted, 1 if the request is not supported, and any other number to indicate an error.'
'The StartService method attempts to place the service into its startup state. It returns one of the following integer values: 0 - The request was accepted. 1 - The request is not supported. 2 - The user did not have the necessary access. 3 - The service cannot be stopped because other services that are running are dependent on it. 4 - The requested control code is not valid, or it is unacceptable to the service. 5 - The requested control code cannot be sent to the service because the state of the service (Win32_BaseService:State) is equal to 0, 1, or 2. 6 - The service has not been started. 7 - The service did not respond to the start request in a timely fashion. 8 - Unknown failure when starting the service. 9 - The directory path to the service executable was not found. 10 - The service is already running. 11 - The database to add a new service is locked. 12 - A dependency for which this service relies on has been removed from the system. 13 - The service failed to find the service needed from a dependent service. 14 - The service has been disabled from the system. 15 - The service does not have the correct authentication to run on the system. 16 - This service is being removed from the system. 17 - There is no execution thread for the service. 18 - There are circular dependencies when starting the service. 19 - There is a service running under the same name. 20 - There are invalid characters in the name of the service. 21 - Invalid parameters have been passed to the service. 22 - The account which this service is to run under is either invalid or lacks the permissions to run the service. 23 - The service exists in the database of services available from the system. 24 - The service is currently paused in the system. '
'The StopService method places the service in the stopped state. It returns an integer value of 0 if the service was successfully stopped, 1 if the request is not supported, and any other number to indicate an error.'
'The DesktopInteract property indicates whether the service can create or communicate with windows on the desktop. Values: TRUE or FALSE. A value of TRUE indicates the service can create or communicate with windows on the desktop.'
'The DisplayName property indicates the display name of the service. This string has a maximum length of 256 characters. The name is case-preserved in the Service Control Manager. DisplayName comparisons are always case-insensitive. Constraints: Accepts the same value as the Name property. Example: Atdisk.'
'If this service fails to start during startup, the ErrorControl property specifies the severity of the error. The value indicates the action taken by the startup program if failure occurs. All errors are logged by the computer system. The computer system does not notify the user of "Ignore" errors. With "Normal" errorsthe user is notified. With "Severe" errors, the system is restarted with the last-known-good configuration. Finally, on"Critical" errors the system attempts to restart with a good configuration.'
'The ExitCode property specifies a Win32 error code defining any problems encountered in starting or stopping the service. This property is set to ERROR_SERVICE_SPECIFIC_ERROR (1066) when the error is unique to the service represented by this class, and information about the error is available in the ServiceSpecificExitCode member. The service sets this value to NO_ERROR when running, and again upon normal termination.'
'The PathName property contains the fully qualified path to the service binary file that implements the service. Example: \SystemRoot\System32\drivers\afd.sys'
'The ServiceSpecificExitCode property specifies a service-specific error code for errors that occur while the service is either starting or stopping. The exit codes are defined by the service represented by this class. This value is only set when the ExitCodeproperty value is ERROR_SERVICE_SPECIFIC_ERROR, 1066.'
'The StartName property indicates the account name under which the service runs. Depending on the service type, the account name may be in the form of "DomainName\Username".The service process will be logged using one of these two forms when it runs. If the account belongs to the built-in domain, ".\Username" can be specified. If NULL is specified, the service will be logged on as the LocalSystem account. For kernel or system level drivers, StartName contains the driver object name (that is, \FileSystem\Rdr or \Driver\Xns) which the input and output (I/O) system uses to load the device driver. Additionally, if NULL is specified, the driver runs with a default object name created by the I/O system based on the service name. Example: DWDOM\Admin.'
'The TagId property specifies a unique tag value for this service in the group. A value of 0 indicates that the service has not been assigned a tag. A tag can be used for ordering service startup within a load order group by specifying a tag order vector in the registry located at: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList. Tags are only evaluated for Kernel Driver and File System Driver start type services that have "Boot" or "System" start modes.'
'CreationClassName indicates the name of the class or the subclass used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.'
'The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.'
'The Name property uniquely identifies the service and provides an indication of the functionality that is managed. This functionality is described in more detail in the object's Description property.'
'The StartMode property indicates the start mode of the Win32 base service. "Boot" specifies a device driver started by the operating system loader. This value is valid only for driver services. "System" specifies a device driver started by the IoInitSystem function. This value is valid only for driver services. "Automatic" specifies a service to be started automatically by the service control manager during system startup. "Manual" specifies a service to be started by the service control manager when a process calls the StartService function. "Disabled" specifies a service that can no longer be started.'
'The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are "OK", "Degraded" and "Pred Fail". "Pred Fail" indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are "Error", "Starting", "Stopping" and "Service". The latter, "Service", could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither "OK" nor in one of the other states.'
'The Win32_BaseService class represents executable objects that are installed in a registry database maintained by the Service Control Manager. The executable file associated with a service can be started at boot time by a boot program or by the system. It can also be started on-demand by the Service Control Manager. Any service or process that is not owned by a specific user, and that provides an interface to some functionality supported by the computer system, is a descendent (or member) of this class. Example: The dynamic host configuration protocol (DHCP) client service on a Windows NT/Windows 2000 computer system.'