images\warning_sml.gifHAN: Invalid Handle (Error Detection)

Example       Related Topics

An HAN message indicates that where a handle was expected, either the value specified was not an active handle, or is a handle of the wrong type. For example, a file handle was specified where a mutex handle was expected.

Purify displays HAN messages when you call an API function that requires a HANDLE parameter and the handle is invalid. A handle is invalid when it is not a valid handle to anything, or it is not the correct type of handle for the specified function. For example, the API function HeapAlloc requires that the first parameter be a handle to the heap from which memory is allocated. Purify generates a HAN message if the handle argument does not identify a valid heap.

Invalid Handle messages are normally hidden by Purify's default error filters. To display the messages:

1.    Select an Error View.

2.    Open the Filter Manager dialog box.

3.    Select View > Global Filters.

4.    Select the Purify Default Filters group and deselect the HAN filter.

5.    Click OK.

(C) Copyright IBM Corporation 1992, 2010.