IAzApplication::CreateRole method (azroles.h)

The CreateRole method creates an IAzRole object with the specified name.

Syntax

HRESULT CreateRole(
  [in]           BSTR    bstrRoleName,
  [in, optional] VARIANT varReserved,
  [out]          IAzRole **ppRole
);

Parameters

[in] bstrRoleName

Name for the new IAzRole object.

[in, optional] varReserved

Reserved for future use.

[out] ppRole

A pointer to a pointer to the created IAzRole object.

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 IAzRole::Submit method to persist any changes made to the returned object.

The returned IAzRole object is an immediate child object of the IAzApplication object.

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