IAzAuthorizationStore::CloseApplication method (azroles.h)

The CloseApplication method unloads a specified IAzApplication object from the cache.

This method is not supported for XML authorization policy stores.

Syntax

HRESULT CloseApplication(
  [in] BSTR bstrApplicationName,
  [in] LONG lFlag
);

Parameters

[in] bstrApplicationName

The name of the IAzApplication object to close.

[in] lFlag

Flags that control the behavior of the operation. The following table shows the possible values.

Value Meaning
0 Child objects of the specified IAzApplication object will be unloaded from the cache only when the user closes the last handle to the IAzApplication object.
AZ_AZSTORE_FORCE_APPLICATION_CLOSE All child objects of the specified IAzApplication object will be forcefully closed. Attempts to reference an open handle to a child object of the specified IAzApplication object will result in an HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE) error. This flag should be used only if the user has implemented code to gracefully handle the error.

Return value

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

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