IAzScope::PolicyAdministratorsName property

The PolicyAdministratorsName property retrieves the account names of principals that act as policy administrators.

This property is read-only.

Syntax


HRESULT get_PolicyAdministratorsName(
  [out] VARIANT *pvarAdmins
);

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 administrator. 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_PolicyAdministratorsName succeeds, it returns S_OK.

Any other HRESULT value indicates that the call failed.

Remarks

Policy administrators for an object can perform the following tasks:

  • Read the object
  • Write attributes to the object
  • Read attributes of child objects of the object
  • Write attributes to child objects of the object
  • Delete the object
  • Delete child objects of the object
  • Create child objects of the object

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: