Win32_ServiceSpecification class

The Win32_ServiceSpecification WMI class represents a service that is to be installed with an associated package.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties and methods are in alphabetic order, not MOF order.

Syntax

[Provider("MSIProv"), Dynamic]
class Win32_ServiceSpecification : CIM_Check
{
  string  Caption;
  string  CheckID;
  Boolean CheckMode;
  string  Dependencies;
  string  Description;
  string  DisplayName;
  sint32  ErrorControl;
  string  ID;
  string  LoadOrderGroup;
  string  Name;
  string  Password;
  sint32  ServiceType;
  string  SoftwareElementID;
  uint16  SoftwareElementState;
  string  StartName;
  sint32  StartType;
  uint16  TargetOperatingSystem;
  string  Version;
};

Members

The Win32_ServiceSpecification class has these types of members:

• Methods
• Properties

Methods

The Win32_ServiceSpecification class has these methods.

Properties

The Win32_ServiceSpecification class has these properties.

Caption

Data type: string

Access type: Read-only

Short textual description of the object a one-line string.

CheckID

Data type: string

Access type: Read-only

Identifier used together with other keys to uniquely identify the check.

CheckMode

Data type: Boolean

Access type: Read-only

Whether or not the condition is expected to exist in the environment. When TRUE, the condition is expected to exist, for example, a file is expected to be on a system, so the Invoke method is expected to return TRUE.

Dependencies

Data type: string

Access type: Read-only

List of names of services or load ordering groups that the system must start before this service. Names in the list are separated by nulls. If the service does not have dependencies, then NULL or an empty string is returned. 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.

Description

Data type: string

Access type: Read-only

Description of an object.

DisplayName

Data type: string

Access type: Read-only

Service identifier that the user interface programs use.

ErrorControl

Data type: sint32

Access type: Read-only

Action that the startup program takes if the service does not start during startup. One of the following error control flags must be specified. Add the value 0x08000 to the following flags to specify that the overall install fails if the service cannot be installed.

Value	Meaning
0x00000000	Logs the error and continues with the startup operation.
0x00000001	Logs the error, displays a message box, and continues the startup operation.
0x00000003	Logs the error if it is possible, and the system is restarted with the last configuration that is known to be good. If the last good configuration is being started, the startup operation fails.

ID

Data type: string

Access type: Read-only

Unique key that identifies the service specification item within its product.

LoadOrderGroup

Data type: string

Access type: Read-only

Name of the load ordering group of which this service is a member.

Name

Data type: string

Access type: Read-only

Name used to identify the software element.

Password

Data type: string

Access type: Read-only

Password associated with StartName.

ServiceType

Data type: sint32

Access type: Read-only

Bit flags that specify the type of service. One of the following service types must be specified.

Value	Meaning
SERVICE_WIN32_OWN_PROCESS 0x00000010	Windows service that runs its own process.
SERVICE_WIN32_SHARE_PROCESS 0x00000020	Windows service that shares a process.
SERVICE_INTERACTIVE_PROCESS 0x00000100	Windows service that interacts with the desktop. This value cannot be used alone, and must be added to one of the two previous types.

The following types of service are unsupported.

Value	Meaning
SERVICE_KERNEL_DRIVER 0x00000001	Driver service.
SERVICE_FILE_SYSTEM_DRIVER 0x00000002	File system driver service.

SoftwareElementID

Data type: string

Access type: Read-only

Identifier for the software element.

SoftwareElementState

Data type: uint16

Access type: Read-only

State of a software element.

Value	Meaning
1	Deployable
2	Installable
3	Executable
4	Running

StartName

Data type: string

Access type: Read-only

Account name used to start this service.

StartType

Data type: sint32

Access type: Read-only

Bit flags that specify when to start a service. One of the following types of service start must be specified.

Value	Meaning
SERVICE_AUTO_START 0x00000002	Service starts during startup of the system.
SERVICE_DEMAND_START 0x00000003	Service starts when the service control manager calls the StartService function.
SERVICE_DISABLED 0x00000004	Service that cannot be started.

The following types of service starts are valid only for driver services.

Value	Meaning
SERVICE_BOOT_START 0x00000000	Device driver started by the operating system loader.
SERVICE_SYSTEM_START 0x00000001	Device driver started by the system initialization process.

TargetOperatingSystem

Data type: uint16

Access type: Read-only

Target operating system of the software element. The possible values for this property are the following:

Value	Meaning
0	Unknown
1	Other
2	MACOS
3	ATTUNIX
4	DGUX
5	DECNT
6	Digital Unix
7	OpenVMS
8	HPUX
9	AIX
10	MVS
11	OS400
12	OS/2
13	JavaVM
14	MSDOS
15	WIN3x
16	WIN95
17	WIN98
18	WINNT
19	WINCE
20	NCR3000
21	NetWare
22	OSF
23	DC/OS
24	Reliant UNIX
25	SCO UnixWare
26	SCO OpenServer
27	Sequent
28	IRIX
29	Solaris
30	SunOS
31	U6000
32	ASERIES
33	TandemNSK
34	TandemNT
35	BS2000
36	LINUX
37	Lynx
38	XENIX
39	VM/ESA
40	Interactive UNIX
41	BSDUNIX
42	FreeBSD
43	NetBSD
44	GNU Hurd
45	OS9
46	MACH Kernel
47	Inferno
48	QNX
49	EPOC
50	IxWorks
51	VxWorks
52	MiNT
53	BeOS
54	HP MPE
55	NextStep
56	PalmPilot
57	Rhapsody

Version

Data type: string

Access type: Read-only

Version of a software element. Values should be in the form [Major].[Minor].[Revision] or [Major].[Minor][letter][revision].

Remarks

The Win32_ServiceSpecification class is derived from CIM_Check.

Requirements

See also

Installed Applications Classes