IAzRole::DeletePropertyItem method (azroles.h)

The DeletePropertyItem method removes the specified entity from the specified list.

Syntax

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

Parameters

[in] lPropId

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

Value Meaning
AZ_PROP_ROLE_APP_MEMBERS
Can also be removed using the DeleteAppMember method
AZ_PROP_ROLE_MEMBERS
Can also be removed using the DeleteMember method
AZ_PROP_ROLE_MEMBERS_NAME
Can also be removed using the DeleteMemberName method
AZ_PROP_ROLE_OPERATIONS
Can also be removed using the DeleteOperation method
AZ_PROP_ROLE_TASKS
Can also be removed using the DeleteTask method

[in] varProp

Entity to remove from the list specified by the lPropId parameter.

The variant must be a BSTR variant.

If AZ_PROP_ROLE_MEMBERS is specified for the lPropId parameter, the string is the security identifier (SID) of the Windows account to remove from the list. If AZ_PROP_ROLE_MEMBERS_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 "ExampleDomain\UserName" format. If AZ_PROP_ROLE_APP_MEMBERS is specified for the lPropId parameter, the string is the Name property of the IAzApplicationGroup object to remove from the list.

[in, optional] varReserved

Reserved for future use.

Return value

The return value is an HRESULT. A value of S_OK indicates success. Any other value indicates that the operation failed.

Requirements

   
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