RSOP_ExtensionStatus class

Provides information about the overall status of a client-side extension's processing of policy.

The following syntax is simplified from MOF code.

Syntax

[AMENDMENT]
class RSOP_ExtensionStatus
{
  string   extensionGuid = "";
  string   displayName = "";
  datetime beginTime;
  datetime endTime;
  uint32   loggingStatus = 1;
  uint32   error = 0;
};

Members

The RSOP_ExtensionStatus class has these types of members:

Properties

The RSOP_ExtensionStatus class has these properties.

beginTime

Data type: datetime

Access type: Read-only

Qualifiers: DisplayName ("Begin Time")

Time at which the client-side extension was last invoked.

displayName

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Name")

Display name of the client-side extension.

endTime

Data type: datetime

Access type: Read-only

Qualifiers: DisplayName ("End Time")

Time at which the client-side extension finished its processing, after it was last invoked.

error

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Error Code")

Error code returned by the client-side extension after it was invoked to process policy.

extensionGuid

Data type: string

Access type: Read-only

Qualifiers: key, DisplayName ("Extension GUID")

GUID of the client-side extension.

loggingStatus

Data type: uint32

Access type: Read-only

Qualifiers: DisplayName ("Status")

The logging status of the extension.

This property can have one of the following values.

Logging - Complete (1)

The client-side extension successfully logged data.

Logging - Not Complete (2)

The client-side extension could not log data. The data might not be complete.

Logging - Not Supported (3)

The client-side extension does not support logging.

Remarks

The system typically logs an instance of RSOP_ExtensionStatus when it begins to log RSoP data. The instance marks the RSoP data as "dirty". If, for some reason, the system does not log this instance of RSOP_ExtensionStatus, policy processing ceases immediately and an error is written to the appropriate event log.

The system also logs an instance of RSOP_ExtensionStatus for each client-side extension before the system calls the extension. The instance marks the extension-specific RSoP data as "dirty". When the client-side extension completes its processing of policy, it must notify the system about the status of the RSoP data the extension logged using the ProcessGroupPolicyEx callback function. The system then marks the extension-specific data as "dirty" or "clean".

After the system logs all required data correctly, it marks the RSoP data "clean", depending on the status of the data.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\RSOP\Computer, Root\RSOP\User
MOF
Rsop.mof
DLL
GPSvc.dll

See also

Group Policy Overview

Group Policy RSoP WMI Classes

RSOP_ExtensionEventSourceLink

RSOP_ExtensionEventSource