IAzApplication::DeletePropertyItem method (azroles.h)

The DeletePropertyItem method removes the specified principal from the specified list of principals.

Syntax

HRESULT DeletePropertyItem(
  [in]           LONG    lPropId,
  [in]           VARIANT varProp,
  [in, optional] VARIANT varReserved
);

Parameters

[in] lPropId

Property ID of the list of principals from which to remove the principal specified by the varProp parameter. The following table shows the possible values.

Value Meaning
AZ_PROP_POLICY_ADMINS
Can also be removed using the DeletePolicyAdministrator method
AZ_PROP_POLICY_ADMINS_NAME
Can also be removed using the DeletePolicyAdministratorName method
AZ_PROP_POLICY_READERS
Can also be removed using the DeletePolicyReader method
AZ_PROP_POLICY_READERS_NAME
Can also be removed using the DeletePolicyReaderName method
AZ_PROP_DELEGATED_POLICY_USERS
Can also be removed using the DeleteDelegatedPolicyUser method
AZ_PROP_DELEGATED_POLICY_USERS_NAME
Can also be removed using the DeleteDelegatedPolicyUserName method

[in] varProp

Principal to remove from the list of principals specified by the lPropId parameter.

The variant must be a BSTR variant.

If AZ_PROP_POLICY_ADMINS, AZ_PROP_POLICY_READERS, or AZ_PROP_DELEGATED_POLICY_USERS is specified for the lPropId parameter, the string is the text form of the security identifier (SID) of the Windows account to remove from the list. If AZ_PROP_POLICY_ADMINS_NAME, AZ_PROP_POLICY_READERS_NAME, or AZ_PROP_DELEGATED_POLICY_USERS_NAME is specified for the lPropId parameter, the string is the account name of the account to remove from the list. The account name can be in either user principal name (UPN) format (for example, "someone@example.com") or in the format of "ExampleDomain\UserName".

[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.

Remarks

You must call the Submit method to persist any changes made by this method.

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