IAzRole::AddMemberName method (azroles.h)

The AddMemberName method adds the specified account name to the list of accounts that belong to the role.

Syntax

HRESULT AddMemberName(
  [in]           BSTR    bstrProp,
  [in, optional] VARIANT varReserved
);

Parameters

[in] bstrProp

String that contains the account name to add to the list of accounts that belong to the role. The account name can be in either user principal name (UPN) format (for example, someone@example.com) or in the ExampleDomain\UserName format. If the domain is not in the ExampleDomain\UserName format, the LookupAccountName function is called to retrieve the domain.

[in, optional] varReserved

Reserved for future use.

Return value

If the method succeeds, it will return S_OK. Any other HRESULT value indicates that the operation failed.

Remarks

To view the list of account names of accounts that belong to this role, use the MembersName property.

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

See also

MembersName

Submit

LookupAccountName