IAzScope::DeletePolicyAdministratorName method (azroles.h)
The DeletePolicyAdministratorName method removes the specified account name from the list of principals that act as policy administrators.
Syntax
HRESULT DeletePolicyAdministratorName(
[in] BSTR bstrAdmin,
[in, optional] VARIANT varReserved
);
Parameters
[in] bstrAdmin
Account name to remove from the list of policy administrators. The account name can be in either user principal name (UPN) format (for example, someone@example.com
) or in the ExampleDomain\UserName
format. If the domain is not in the ExampleDomain\UserName
format, the LookupAccountName function is called to retrieve the domain.
[in, optional] varReserved
Reserved for future use.
Return value
If the method succeeds, it will return S_OK
. Any other HRESULT value indicates that the operation 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
To view the list of policy administrators in account name format, use the PolicyAdministratorsName 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 |