Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Accessing reference counting objects in object containers

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.