IAzAuthorizationStore::Delete method (azroles.h)

The Delete method deletes the policy store currently in use by the AzAuthorizationStore object.

Syntax

HRESULT Delete(
  [in, optional] VARIANT varReserved
);

Parameters

[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

When the Delete method is called, the AzAuthorizationStore object returns to an uninitialized state. The Initialize method can then be called to reinitialize the object.

Important

All objects opened by clients on the policy store (for example, IAzApplication objects created using CreateApplication) must be released before you call the Delete method. If the Delete method is called on an AzAuthorizationStore object whose current policy store contains child objects, HRESULT_FROM_WIN32(ERROR_SERVER_HAS_OPEN_HANDLES) is returned.

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

IAzApplication

AzAuthorizationStore

CreateApplication