Instruction set reference
HIPE_OP_LOCATION_RETURN
Sent to the client by the display server in reply to a request for a location handle to a particular element.
- requestor: A copy of whatever value was passed when the request was made.
- location: The location handle that was requested.
Notes
Location handles should be freed using HIPE_OP_FREE_LOCATION when no longer required. They are also freed automatically when the client application terminates.
The location value 0 is returned if the element does not exist or the element exists but its location handle has been freed/de-allocated from use. (With the C++ library, this can happen if all hipe::loc objects corresponding to an element have been discarded.)