POLICYSETTINGSTATUSINFO structure (userenv.h)

Article
02/22/2024

The POLICYSETTINGSTATUSINFO structure provides information about a policy-setting event.

Syntax

typedef struct _POLICYSETTINGSTATUSINFO {
  LPWSTR        szKey;
  LPWSTR        szEventSource;
  LPWSTR        szEventLogName;
  DWORD         dwEventID;
  DWORD         dwErrorCode;
  SETTINGSTATUS status;
  SYSTEMTIME    timeLogged;
} POLICYSETTINGSTATUSINFO, *LPPOLICYSETTINGSTATUSINFO;

Members

szKey

This member is optional. If it is NULL, the system generates a value.

szEventSource

Pointer to a string specifying the name of the source (application, service, driver, subsystem) that generated the log entry.

szEventLogName

Pointer to a string specifying the name of the event log.

dwEventID

Specifies the event log message ID.

dwErrorCode

A system error code that indicates an error that occurred during the application of the policy setting.

status

Specifies the status of the policy setting. This member can be one of the following values.

RSOPUnspecified

The client-side extension does not define a status for this policy setting.

RSOPApplied

The policy setting was applied successfully.

RSOPIgnored

The policy setting was ignored; the system made no attempt to apply it.

RSOPFailed

Application of the policy setting failed. Details about the failure are indicated by the other members of the structure.

RSOPSubsettingFailed

The policy setting was applied successfully, but an error occurred while attempting to apply the child setting.

timeLogged

Specifies a SYSTEMTIME structure that indicates the time at which the source generated the event.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	userenv.h