wmi Win32_BaseService reference for Network Programming in .NET with C# & Visual Basic .NET (VB.NET)

WMI class ' Win32_BaseService ' reference for C# and VB.NET

MOF Reference

[Description("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.\nExample: The dynamic host configuration protocol (DHCP) client service on a Windows NT/Windows 2000 computer system."): ToSubClass, DisplayName("System Drivers and Services"), AMENDMENT, LOCALE(1033)]
class Win32_BaseService : CIM_Service
{
	[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."): ToSubClass, Values{"Boot", "System", "Auto", "Manual", "Disabled"}: ToSubClass, DisplayName("Start Mode")] string StartMode = NULL;
	[DisplayName("Service Accepts Pause"), Description("The AcceptPause property indicates whether the service can be paused.\nValues: TRUE or FALSE. A value of TRUE indicates the service can be paused."): ToSubClass] boolean AcceptPause;
	[DisplayName("Service Accepts Stop"), Description("The AcceptStop property indicates whether the service can be stopped.\nValues: TRUE or FALSE. A value of TRUE indicates the service can be stopped."): ToSubClass] boolean AcceptStop;
	[DisplayName("Interacts With Desktop"), Description("The DesktopInteract property indicates whether the service can create or communicate with windows on the desktop.\nValues: TRUE or FALSE. A value of TRUE indicates the service can create or communicate with windows on the desktop."): ToSubClass] boolean DesktopInteract;
	[DisplayName("Display Name"), Description("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. \nConstraints: Accepts the same value as the Name property.\nExample: Atdisk."): ToSubClass] string DisplayName;
	[DisplayName("Severity Of Startup Failure"), Description("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\" 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."): ToSubClass, Values{"Ignore", "Normal", "Severe", "Critical", "Unknown"}: ToSubClass] string ErrorControl;
	[DisplayName("File Path Name"), Description("The PathName property contains the fully qualified path to the service binary file that implements the service.\nExample: \\SystemRoot\\System32\\drivers\\afd.sys"): ToSubClass] string PathName;
	[DisplayName("Service Type"), Description("The ServiceType property supplies the type of service provided to calling processes."): ToSubClass, Values{"Kernel Driver", "File System Driver", "Adapter", "Recognizer Driver", "Own Process", "Share Process", "Interactive Process"}: ToSubClass] string ServiceType;
	[DisplayName("Starting Account Name"), Description("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.\nExample: DWDOM\\Admin."): ToSubClass] string StartName;
	[DisplayName("State"), Description("The State property indicates the current state of the base service."): ToSubClass, Values{"Stopped", "Start Pending", "Stop Pending", "Running", "Continue Pending", "Pause Pending", "Paused", "Unknown"}: ToSubClass] string State;
	[DisplayName("Tag Id"), Description("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."): ToSubClass] uint32 TagId;
	[DisplayName("Exit Code"), Description("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."): ToSubClass] uint32 ExitCode;
	[DisplayName("Server Specific Exit Code"), Description("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."): ToSubClass] uint32 ServiceSpecificExitCode;
	[Description("The StartService method attempts to place the service into its startup state. It returns one of the following integer values: \n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 StartService();
	[Description("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.\tIt returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 StopService();
	[Description("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. It returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 PauseService();
	[Description("The ResumeService method attempts to place the service in the resumed state. It returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 ResumeService();
	[Description("The InterrogateService method requests that the service update its state to the service manager. It returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 InterrogateService();
	[Description("The UserControlService method attempts to send a user-defined control code to a service. It returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 UserControlService([In, Description("The ControlCode parameter specifies defined values(from 128 to 255) that provide control commands specific to a user."): ToSubClass] uint8 ControlCode);
	[Description("The Create method creates a new service. 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. It returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 Create([In, 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."): ToSubClass] string Name, [In, 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. \nConstraints: Accepts the same value as the Name parameter.\nExample: Atdisk."): ToSubClass] string DisplayName, [In, Description("The PathName parameter passes the fully qualified path to the executable file that implements the service.\nExample: \\SystemRoot\\System32\\drivers\\afd.sys"): ToSubClass] string PathName, [In, Description("The ServiceType parameter passes the type of services provided to processes that call them."): ToSubClass, BitValues{"Kernel Driver", "File System Driver", "Adapter", "Recognizer Driver", "Own Process", "Share Process"}: ToSubClass] uint8 ServiceType, [In, 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."): ToSubClass, Values{"Ignore", "Normal", "Severe", "Critical"}: ToSubClass] uint8 ErrorControl, [In, 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."): ToSubClass, Values{"Boot Start", "System Start", "Auto Start", "Demand Start", "Disabled"}: ToSubClass] string StartMode, [In, Description("The DesktopInteract parameter passes the value that indicates whether the service can create or communicate with windows on the desktop.\nValues: TRUE or FALSE. A value of TRUE indicates the service can create or communicate with windows on the desktop."): ToSubClass] boolean DesktopInteract, [In, 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.\nExample: DWDOM\\Admin."): ToSubClass] string StartName, [In, 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. "): ToSubClass] string StartPassword, [In, 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:\nHKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Control\\ServiceGroupOrder."): ToSubClass] string LoadOrderGroup, [In, 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."): ToSubClass] string LoadOrderGroupDependencies[], [In, 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."): ToSubClass] string ServiceDependencies[]);
	[Description("The Change method modifies a service. 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.It returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 Change([In, 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. \nConstraints: Accepts the same value as the Name parameter.\nExample: Atdisk "): ToSubClass] string DisplayName, [In, Description("The PathName parameter passes the fully qualified path of the service binary file that implements the service.\nExample: \\SystemRoot\\System32\\drivers\\afd.sys"): ToSubClass] string PathName, [In, Description("The ServiceType parameter passes the type of service provided to processes calling the service."): ToSubClass, BitValues{"Kernel Driver", "File System Driver", "Adapter", "Recognizer Driver", "Own Process", "Share Process"}: ToSubClass] uint8 ServiceType, [In, 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."): ToSubClass, Values{"Ignore", "Normal", "Severe", "Critical"}: ToSubClass] uint8 ErrorControl, [In, 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."): ToSubClass, Values{"Boot Start", "System Start", "Auto Start", "Demand Start", "Disabled"}: ToSubClass] string StartMode, [In, Description("The DesktopInteract parameter passes the value that indicates whether the service can create or communicate with windows on the desktop.\nValues: TRUE or FALSE. A value of TRUE indicates the service can create or communicate with windows on the desktop."): ToSubClass] boolean DesktopInteract, [In, 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.\nExample: DWDOM\\Admin."): ToSubClass] string StartName, [In, 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. "): ToSubClass] string StartPassword, [In, 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:\nHKEY_LOCAL_MACHINE\\System\\CurrentControlSet\\Control\\ServiceGroupOrder."): ToSubClass] string LoadOrderGroup, [In, 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."): ToSubClass] string LoadOrderGroupDependencies[], [In, 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."): ToSubClass] string ServiceDependencies[]);
	[Description("The ChangeStartMode method modifies the StartMode of a service. It returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 ChangeStartMode([In, 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."): ToSubClass, Values{"Boot Start", "System Start", "Auto Start", "Demand Start", "Disabled"}: ToSubClass] string StartMode);
	[Description("The Delete method deletes an existing service. It returns one of the following integer values:\n0 - The request was accepted.\n1 - The request is not supported.\n2 - The user did not have the necessary access.\n3 - The service cannot be stopped because other services that are running are dependent on it.\n4 - The requested control code is not valid, or it is unacceptable to the service.\n5 - 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.\n6 - The service has not been started.\n7 - The service did not respond to the start request in a timely fashion.\n8 - Unknown failure when starting the service.\n9 - The directory path to the service executable was not found.\n10 - The service is already running.\n11 - The database to add a new service is locked.\n12 - A dependency for which this service relies on has been removed from the system.\n13 - The service failed to find the service needed from a dependent service.\n14 - The service has been disabled from the system.\n15 - The service does not have the correct authentication to run on the system.\n16 - This service is being removed from the system.\n17 - There is no execution thread for the service.\n18 - There are circular dependencies when starting the service.\n19 - There is a service running under the same name.\n20 - There are invalid characters in the name of the service.\n21 - Invalid parameters have been passed to the service.\n22 - The account, which this service is to run under is either invalid or lacks the permissions to run the service.\n23 - The service exists in the database of services available from the system.\n24 - The service is currently paused in the system.\nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Not Supported", "Access Denied", "Dependent Services Running", "Invalid Service Control", "Service Cannot Accept Control", "Service Not Active", "Service Request Timeout", "Unknown Failure", "Path Not Found", "Service Already Running", "Service Database Locked", "Service Dependency Deleted", "Service Dependency Failure", "Service Disabled", "Service Logon Failed", "Service Marked For Deletion", "Service No Thread", "Status Circular Dependency", "Status Duplicate Name", "Status Invalid Name", "Status Invalid Parameter", "Status Invalid Service Account", "Status Service Exists", "Service Already Paused", "Other"}: ToSubClass] uint32 Delete();
};

Class properties:

Win32_BaseService.AcceptPause
Win32_BaseService.AcceptStop
Win32_BaseService.Caption
Win32_BaseService.CreationClassName
Win32_BaseService.Description
Win32_BaseService.DesktopInteract
Win32_BaseService.DisplayName
Win32_BaseService.ErrorControl
Win32_BaseService.ExitCode
Win32_BaseService.InstallDate
Win32_BaseService.Name
Win32_BaseService.PathName
Win32_BaseService.ServiceSpecificExitCode
Win32_BaseService.ServiceType
Win32_BaseService.Started
Win32_BaseService.StartMode
Win32_BaseService.StartName
Win32_BaseService.State
Win32_BaseService.Status
Win32_BaseService.SystemCreationClassName
Win32_BaseService.SystemName
Win32_BaseService.TagId

WMI is a huge subject, so therefore it is practically impossible to provide a comprehensive example program that covers anything. However, the book �Network programming in .NET� (Buy at Amazon UK) (Buy at Amazon US) covers a much wider scope of WMI, and explains how to leverage it to access the bounty of information held within this vast, yet simple object model.

Articles

Contact us

Please use FireFox to view this page

WMI class ' Win32_BaseService ' reference for C# and VB.NET

MOF Reference

Class properties: