The Win32_LogicalProgramGroup WMI class represents a program group in a computer system running Windows. For example, Accessories or Startup.
The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties and methods are in alphabetic order, not MOF order.
Syntax
[Dynamic, Provider("CIMWin32"), Privileges("SeRestorePrivilege"), UUID("{D52706F2-8045-11d2-90CE-0060081A46FD}"), AMENDMENT]
class Win32_LogicalProgramGroup : Win32_ProgramGroupOrItem
{
string Caption;
string Description;
datetime InstallDate;
string Status;
string GroupName;
string Name;
string UserName;
};
Members
The Win32_LogicalProgramGroup class has these types of members:
Properties
The Win32_LogicalProgramGroup class has these properties.
Caption
Data type: string
Access type: Read-only
Qualifiers: MaxLen (64), DisplayName ("Caption")
A short textual description of the object.
This property is inherited from CIM_ManagedSystemElement.
Description
Data type: string
Access type: Read-only
Qualifiers: DisplayName ("Description")
A textual description of the object.
This property is inherited from CIM_ManagedSystemElement.
GroupName
Data type: string
Access type: Read-only
Qualifiers: MappingStrings ("Win32API|CWbemProviderGlue Class Methods|GetAllInstances")
Name of the Windows program group. Program groups are implemented as file folders in Win32.
Example: "Accessories\System Tools"
InstallDate
Data type: datetime
Access type: Read-only
Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Install Date")
Indicates when the object was installed. Lack of a value does not indicate that the object is not installed.
This property is inherited from CIM_ManagedSystemElement.
Name
Data type: string
Access type: Read-only
Qualifiers: Override ("Name"), key, MaxLen (256), MappingStrings ("Win32API|CWbemProviderGlue Class Methods|GetAllInstances")
User-assigned name followed by the group name. Program groups are implemented as file folders in Win32.
Example: "All Users:Accessories\System Tools"
Status
Data type: string
Access type: Read-only
Qualifiers: MaxLen (10), DisplayName ("Status")
String that indicates the current status of the object. Operational and non-operational status can be defined. Operational status can include "OK", "Degraded", and "Pred Fail". "Pred Fail" indicates that an element is functioning properly, but is predicting a failure (for example, a SMART-enabled hard disk drive).
Non-operational status can include "Error", "Starting", "Stopping", and "Service". "Service" can apply during disk mirror-resilvering, reloading a user permissions list, or other administrative work. Not all such work is online, but the managed element is neither "OK" nor in one of the other states.
This property is inherited from CIM_ManagedSystemElement.
Values include the following:
OK ("OK")
Error ("Error")
Degraded ("Degraded")
Unknown ("Unknown")
Pred Fail ("Pred Fail")
Starting ("Starting")
Stopping ("Stopping")
Service ("Service")
Stressed ("Stressed")
NonRecover ("NonRecover")
No Contact ("No Contact")
Lost Comm ("Lost Comm")
UserName
Data type: string
Access type: Read-only
Qualifiers: MappingStrings ("Win32API|CWbemProviderGlue Class Methods|GetAllInstances")
Users who can access the Windows program group. Program groups are implemented as file folders in Win32.
Example: "All Users"
Remarks
The Win32_LogicalProgramGroup class is derived from Win32_ProgramGroupOrItem.
The calling process that uses this class must have the SE_RESTORE_NAME privilege on the computer in which the registry resides. For example, if you enumerate this class on the local computer, the account under which your application runs must have this privilege. For more information, see Executing Privileged Operations.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Namespace | Root\CIMV2 |
| MOF | CIMWin32.mof |
| DLL | CIMWin32.dll |
See also
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
