IAzApplication::DeleteDelegatedPolicyUserName method (azroles.h)

Article
07/27/2022

The DeleteDelegatedPolicyUserName method removes the specified account name from the list of principals that act as delegated policy users.

Syntax

HRESULT DeleteDelegatedPolicyUserName(
  [in]           BSTR    bstrDelegatedPolicyUser,
  [in, optional] VARIANT varReserved
);

Parameters

[in] bstrDelegatedPolicyUser

The account name to remove from the list of delegated policy users. The account name must be in user principal name (UPN) format (for example, "someone@example.com"). The LookupAccountName function is called to retrieve the domain.

[in, optional] varReserved

Reserved for future use.

Return value

If the method succeeds, the method returns S_OK.

Any other HRESULT value indicates that the operation failed. An attempt to call this method on an XML store will return E_INVALIDARG.

Remarks

Delegated policy users are principals that are allowed to read the subset of the policy data that the policy administrator of an IAzApplication object uses to administer the delegated object.

Note Delegated policy users are not supported for XML stores.

To view the list of delegated policy users in account name format, use the DelegatedPolicyUsersName property.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	azroles.h
Library	Azroles.lib
DLL	Azroles.dll
Redistributable	Windows Server 2003 Administration Tools Pack on Windows XP

Share via