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 |