IAzRole::AddPropertyItem method (azroles.h)
The AddPropertyItem method adds the specified entity to the specified list.
Syntax
HRESULT AddPropertyItem(
[in] LONG lPropId,
[in] VARIANT varProp,
[in, optional] VARIANT varReserved
);
Parameters
[in] lPropId
Property ID of the list to which to add the entity specified by the varProp parameter. The following table shows the possible values.
Value | Meaning |
---|---|
|
Can also be added using the AddAppMember method |
|
Can also be added using the AddMember method |
|
Can also be added using the AddMemberName method |
|
Can also be added using the AddOperation method |
|
Can also be added using the AddTask method |
[in] varProp
Entity to add to 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 text form of the security identifier (SID) of the Windows account to add to the list. If AZ_PROP_ROLE_MEMBERS_NAME is specified for the lPropId parameter, the string is the account name of the account to add to 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 add to 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.
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 |