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 creates a Container object only when that object does not exist. If the object exists, the existing object is returned.

Attention: The application does not call delete on any objects that are 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 consists of UTF-8 or Unicode characters, which can 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