IAzApplication::CreateRole method (azroles.h)

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


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


[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.


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.


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