IAzScope::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

The return value is an HRESULT. A value of S_OK indicates success. Any other 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 IAzScope object.

Requirements