IGPMRSOP

IGPMRSOP interface

The IGPMRSOP interface provides methods that support making Resultant Set of Policy (RSoP) queries in both logging and planning mode. The typical use of this interface is to set various properties required for a particular RSoP query and then to call the CreateQueryResults method. RSoP planning mode requires Windows Server on the domain controller used to perform the query. RSoP logging mode requires that the computer being targeted be running Windows Server. To create a GPMRSOP object, call the IGPM::GetRSOP method.

Members

The IGPMRSOP interface inherits from the IUnknown interface. IGPMRSOP also has these types of members:

Methods

The IGPMRSOP interface has these methods.

MethodDescription
CreateQueryResults

Executes a Resultant Set of Policy (RSoP) query that supports both logging mode and planning mode queries.

GenerateReport

Generates an RSoP report based on the query specified in GenerateReport.

GenerateReportToFile

Generates an RSoP report based on the query specified in GenerateReportToFile and saves it to a file at a specified path.

LoggingEnumerateUsers

Enumerates all users who have logging mode data on a specific computer.

ReleaseQueryResults

Releases the WMI namespace allocated by a call to the IGPMRSOP::CreateQueryResults method.

 

Properties

The IGPMRSOP interface has these properties.

PropertyAccess typeDescription

LoggingComputer

Read-only

Name of the computer being logged.

LoggingFlags

Read-only

Logging mode flags. This property can be one of the following:

  • RSOP_NO_COMPUTER
  • RSOP_NO_USER

RSOP_NO_COMPUTER and RSOP_NO_USER must not be specified together.

LoggingUser

Read-only

Name of the user targeted in logging mode.

Mode

Read-only

RSOP mode. This property can be one of the following: rsopUnknown, rsopPlanning, or rsopLogging.

Namespace

Read-only

RSOP WMI namespace generated as output from an RSoP simulation. The format is typically "\\computername\root\rsop\namespace".

PlanningComputer

Read-only

Name of the computer to use during planning mode simulation. This is the SAM account name of the Computer object; for example, example\computer.

PlanningComputerSecurityGroups

Read-only

Security groups to associate with the computer during planning mode simulation. This property is an array of variants that contain IGPMTrustee interface pointers.

PlanningComputerSOM

Read-only

Scope of management (SOM) to use for the computer during planning mode simulation. This is the distinguished name of the Active Directory container in which the computer object resides, for purposes of the RSoP simulation. It is not necessary that this property be the true location where the object currently resides.

PlanningComputerWMIFilters

Read-only

WMI filter to associate with the computer during planning mode simulation. This property is an array of variants that contain IGPMWMIFilter interface pointers.

PlanningDomainController

Read-only

Name of the DC to use in planning mode. This can be a DNS name or a NetBIOS name.

PlanningFlags

Read-only

Planning mode flags. The value of this property can be one or more of the following constants combined with OR operators.

  • RSOP_NO_COMPUTER
  • RSOP_NO_USER
  • RSOP_PLANNING_ASSUME_SLOW_LINK
  • RSOP_PLANNING_ASSUME_LOOPBACK_MERGE
  • RSOP_PLANNING_ASSUME_LOOPBACK_REPLACE
  • RSOP_PLANNING_ASSUME_USER_WQLFILTER_TRUE
  • RSOP_PLANNING_ASSUME_COMP_WQLFILTER_TRUE

RSOP_NO_COMPUTER and RSOP_NO_USER must not be specified together.

RSOP_PLANNING_ASSUME_LOOPBACK_MERGE and RSOP_PLANNING_ASSUME_LOOPBACK_REPLACE must not be specified together.

PlanningSiteName

Read-only

Name of the site to use during planning mode simulation; for example, Default-first-site-name.

PlanningUser

Read-only

Name of the user for planning mode simulation. This is the Security Accounts Manager (SAM) account name of the User object; for example, example\user.

PlanningUserSecurityGroups

Read-only

Security groups to associate with the user during planning mode simulation. This property is an array of variants that contain IGPMTrustee interface pointers.

PlanningUserSOM

Read-only

Name of the user scope of management (SOM) to use during planning mode simulation. This is the distinguished name of the Active Directory container in which the user object resides, for purposes of the RSoP simulation. It is not necessary that this property be the true location where the object currently resides.

PlanningUserWMIFilters

Read-only

WMI filters to associate with the user during planning mode simulation. This property is an array of IGPMWMIFilter interface pointers.

 

Remarks

For more information about security groups, see How Security Groups are Used in Access Control in the Active Directory Programmer's Guide.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Gpmgmt.h

IDL

Gpmgmt.idl

DLL

Gpmgmt.dll

IID

IID_IGPMRSOP is defined as 49ED785A-3237-4FF2-B1F0-FDF5A8D5A1EE

See also

IGPM
IGPMWMIFilter
IGPMTrustee

 

 

Show:
© 2016 Microsoft