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.