IAzApplication::DeleteRole method (azroles.h)

Article
02/22/2024

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