Export (0) Print
Expand All

IAzAuthorizationStore::AddPropertyItem method

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

lPropId [in]

Property ID of the list of principals to which to add the principal specified by the varProp parameter. This parameter can be one of the following values.

ValueMeaning
AZ_PROP_POLICY_ADMINS

Can also be added by using the AddPolicyAdministrator method.

AZ_PROP_POLICY_ADMINS_NAME

Can also be added by using the AddPolicyAdministratorName method.

AZ_PROP_POLICY_READERS

Can also be added by using the AddPolicyReader method.

AZ_PROP_POLICY_READERS_NAME

Can also be added by using the AddPolicyReaderName method.

AZ_PROP_DELEGATED_POLICY_USERS

Can also be added by using the AddDelegatedPolicyUser method.

AZ_PROP_DELEGATED_POLICY_USERS_NAME

Can also be added by using the AddDelegatedPolicyUserName method.

 

varProp [in]

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").

varReserved [in, optional]

Reserved for future use.

Return value

If the method succeeds, the method returns S_OK.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

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

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Redistributable

Windows Server 2003 Administration Tools Pack on Windows XP

Header

Azroles.h

Library

Azroles.lib

DLL

Azroles.dll

IID

IID_IAzAuthorizationStore is defined as edbd9ca9-9b82-4f6a-9e8b-98301e450f14

 

 

Community Additions

ADD
Show:
© 2014 Microsoft