lookupContainer Member Function

Allows the Listener to create a Container object, the member functions of which can be used to create Event objects and Meter objects. This function will create a Container object only when that object does not already exist. If the object already exists, the existing object is returned.

CAUTION The application should not call delete on any objects returned by this function.

Syntax
Container *lookupContainer(const char *containerName);
Container *lookupContainer(const wchar_t *containerName);
Parameters
containerName - [in] Required pointer to a string, which provides the name of the Container object. The string should consist of UTF-8 or Unicode characters, which may contain any printable characters excluding the newline character.
Example
Listener *listener = new Listener("sampleApp", "4.0", NULL, false);
Container *store = listener->lookupContainer("storeName");
Event *creations = store->lookupEvent("document creations", false);
Meter *cacheSize = store->lookupMeter("cache size");
...
See Also
Container Class
Event Class
Listener Class
Meter Class