This topic has not yet been rated - Rate this topic

Win32_PrivilegesStatus class

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

class Win32_PrivilegesStatus : __ExtendedStatus
{
  string Description;
  string Operation;
  string ParameterInfo;
  string PrivilegesNotHeld[];
  string PrivilegesRequired[];
  string ProviderName;
  uint32 StatusCode;
};

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.

Operation

Data type: string
Access type: Read-only

Operation that was taking place at the time of the failure or anomaly. WMI typically sets this property to the name of a WMI API method, such as CreateInstanceEnum.

ParameterInfo

Data type: string
Access type: Read-only

One or more parameters involved in the error or status change. For example, if an application attempted to retrieve a class that does not exist, ParameterInfo is set to the offending class name.

PrivilegesNotHeld

Data type: string array
Access type: Read-only

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

Example: "SE_SHUTDOWN_NAME"

PrivilegesRequired

Data type: string array
Access type: Read-only

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

Provider that caused or reported the error or status change. If a provider was not involved, this string is set to "Windows Management".

StatusCode

Data type: uint32
Access type: Read-only

Returned status value.

Remarks

The Win32_PrivilegesStatus class is derived from __ExtendedStatus.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Namespace	\root\CIMV2
MOF	Cimwin32.mof
DLL	Cimwin32.dll

Community Additions

ADD