The find-handle number is an integer which uniquely identifies a reference counting object with respect to its object container.
Given a find-handle number, a pointer to the corresponding reference counting object can be retrieved using CObjectCon::At()
or CObjectCon::AtL()
.
The find-handle number is a TInt value which combines the unique ID of the object container with the index of the reference counting object within that object container's array. The combination of the two values is non-destructive, i.e. given a find-handle number, both the unique ID part and the index part can be extracted.