IAzAuthorizationStore::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 |
---|---|
|
Can also be removed using the DeletePolicyAdministrator method |
|
Can also be removed using the DeletePolicyAdministratorName method |
|
Can also be removed using the DeletePolicyReader method |
|
Can also be removed using the DeletePolicyReaderName method |
|
Can also be removed using the DeleteDelegatedPolicyUser method |
|
Can also be removed using the DeleteDelegatedPolicyUserName method |
[in] varProp
The 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_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 must be in user principal name (UPN) format (for example, "someone@example.com").
[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 |