IAzApplication::AddPropertyItem method (azroles.h)
The AddPropertyItem method adds the specified principal to the specified list of principals.
Syntax
HRESULT AddPropertyItem(
[in] LONG lPropId,
[in] VARIANT varProp,
[in, optional] VARIANT varReserved
);
Parameters
[in] lPropId
Property ID of the list of principals to which to add the principal specified by the varProp parameter. The following table shows the possible values.
Value | Meaning |
---|---|
|
Can also be added using the AddPolicyAdministrator method |
|
Can also be added using the AddPolicyAdministratorName method |
|
Can also be added using the AddPolicyReader method |
|
Can also be added using the AddPolicyReaderName method |
|
Can also be added using the AddDelegatedPolicyUser method |
|
Can also be added using the AddDelegatedPolicyUserName method |
[in] varProp
Principal to add to 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 add to 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 |