IAzApplication::DeleteRole method (azroles.h)

The DeleteRole method removes the IAzRole object with the specified name from the IAzApplication object.

Syntax

HRESULT DeleteRole(
  [in]           BSTR    bstrRoleName,
  [in, optional] VARIANT varReserved
);

Parameters

[in] bstrRoleName

Name of the IAzRole object to delete.

[in, optional] varReserved

Reserved for future use.

Return value

If the method succeeds, it will return S_OK. Any other HRESULT value indicates that the operation failed.

Remarks

If there are any IAzRole references to an IAzRole object that has been deleted from the cache, the IAzRole object can no longer be used. In C++, you must release references to deleted IAzRole objects by calling the IUnknown::Release method. In C# and Visual Basic, references to deleted objects are automatically released.

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

See also

IAzRole

IAzApplication