IAzScope::PolicyReadersName property

The PolicyReadersName property retrieves the account names of principals that act as policy readers.

This property is read-only.

Syntax


HRESULT get_PolicyReadersName(
  [out] VARIANT *pvarReaders
);

Property value

Variant used to return a SAFEARRAY. Each element of the SAFEARRAY is a Variant of type String that contains the account name of a principal that acts as a policy reader. The account names are stored as security identifiers (SIDs) and are translated to user principal name (UPN) format (for example, "someone@example.com") before they are returned. If a SID cannot be translated into a UPN, the account name is returned in the "ExampleDomain\UserName" format.

Error codes

If the property access method get_PolicyReadersName succeeds, it returns S_OK.

Any other HRESULT value indicates that the call failed.

Remarks

Policy readers for an object can read attributes for the object and for child objects of the object. Readers can also use the policy; for example, readers can call the AccessCheck method. Readers cannot modify the object or its child objects.

In JScript, the returned SAFEARRAY must be converted to the JScript Array object.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Redistributable

Windows Server 2003 Administration Tools Pack on Windows XP

Header

Azroles.h

Library

Azroles.lib

DLL

Azroles.dll

IID

IID_IAzScope is defined as 00e52487-e08d-4514-b62e-877d5645f5ab

 

 

Show: