A pointer to an individual reference counting object can be retrieved from its object container using either CObjectCon::At()
or CObjectCon::AtL()
, provided that the reference counting object's find-handle number is known.
A reference counting object's find-handle number can be found using either CObjectCon::FindByName()
or CObjectCon::FindByFullName()
.
FindByName() uses a match pattern to find all reference counting object's with a matching name. FindByFullName() is similar except that the reference counting object's full name is used.
In practice, retrieving a pointer to a reference counting object requires a call to either FindByName() or FindByFullName() followed by a call to either At()
or AtL()
.
FindByName() and FindByFullName() are suited to finding a single object with a specific name or all objects with a generic type of name.