IAzApplication::CreateRole method

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

Syntax

HRESULT CreateRole(
  BSTR    bstrRoleName,
  VARIANT varReserved,
  IAzRole **ppRole
);

Parameters

bstrRoleName

Name for the new IAzRole object.

varReserved

Reserved for future use.

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

   
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