System.AcquireExceptionObject

• Up to Parent: System

Delphi

function AcquireExceptionObject: Pointer;

C++

extern DELPHI_PACKAGE void * __fastcall AcquireExceptionObject(void);

Properties

Type	Visibility	Source	Unit	Parent
function	public	System.pas System.hpp	System	System

Description

Retains access to the exception object.

AcquireExceptionObject returns a pointer to the current exception object and prevents the exception object from being deallocated when the current exception handler exits.

Note: AcquireExceptionObject increments the exception object's reference count. Make sure that the reference count is decremented when the exception object is no longer needed. This happens automatically if you use the exception object to raise the exception again. In all other cases, every call to AcquireExceptionObject must have a matching call to ReleaseExceptionObject. AcquireExceptionObject/ReleaseExceptionObject sequences can be nested.

See Also

• ReleaseExceptionObject

• ExceptObject

Code Examples

• ExceptionHandling (Delphi)