Win32_PrivilegesStatus class (CIMWin32 WMI Providers)

The Win32_PrivilegesStatus WMI class reports information about privileges required to complete an operation. It may be returned when an operation failed or when a partially populated instance has been returned.

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

[UUID("{BE46D060-7A7C-11d2-BC85-00104B2CF71C}"), AMENDMENT]
class Win32_PrivilegesStatus : __ExtendedStatus
{
  string Description;
  string Operation;
  string ParameterInfo;
  string ProviderName;
  uint32 StatusCode;
  string PrivilegesNotHeld[];
  string PrivilegesRequired[];
};

Members

The Win32_PrivilegesStatus class has these types of members:

• Properties

Properties

The Win32_PrivilegesStatus class has these properties.

Description

Data type: string

Access type: Read-only

Any user-defined string that describes an error or operational status.

This property is inherited from __ExtendedStatus.

Operation

Data type: string

Access type: Read-only

Operation that takes place at the time of a failure or anomaly. Typically, Windows Management Instrumentation (WMI) sets this property to the name of a COM API for WMI method such as the following: IWbemServices::CreateInstanceEnum.

This property is inherited from __ExtendedStatus.

ParameterInfo

Data type: string

Access type: Read-only

Parameters involved in an error or status change. For example, if an application attempts to retrieve a class that does not exist, this property is set to the offending class name.

This property is inherited from __ExtendedStatus.

PrivilegesNotHeld

Data type: string array

Access type: Read-only

Qualifiers: MappingStrings ("Win32API|AccessControl|Windows NT Privileges")

Listing required access privileges missing to complete an operation. The types of access privileges can be found under the Windows Privileges.

Example: "SE_SHUTDOWN_NAME"

PrivilegesRequired

Data type: string array

Access type: Read-only

Qualifiers: MappingStrings ("Win32API|AccessControl|Windows NT Privileges")

Listing of all of the privileges required to perform an operation. This includes values from the PrivilegesNotHeld property.

Example: "SE_SHUTDOWN_NAME"

ProviderName

Data type: string

Access type: Read-only

Identifies the provider that causes or reports an error or status change. If a provider is not involved, this string is set to "Windows Management".

This property is inherited from __ExtendedStatus.

StatusCode

Data type: uint32

Access type: Read-only

Contains an error or information code for an operation. This can be any value defined by the provider, but the value 0 (zero) is usually reserved to indicate success.

This property is inherited from __NotifyStatus.

Remarks

The Win32_PrivilegesStatus class is derived from __ExtendedStatus.

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

__ExtendedStatus