TFindHandleBase Class Reference

#include <e32std.h>

class TFindHandleBase : public TFindHandle

Inherits from

Public Member Functions
TFindHandleBase()
TFindHandleBase(const TDesC &)
IMPORT_C voidFind(const TDesC &)
Protected Member Functions
TInt NextObject(TFullName &, TInt)
Inherited Functions
TFindHandle::Handle()const
TFindHandle::Reset()
TFindHandle::TFindHandle()

Detailed Description

Base class for searching for global kernel objects.

This is the base class for a number of classes which are used to find specific types of global kernel object such as semaphores, threads and mutexes; TFindSemaphore, TFindThread and TFindMutex are typical examples of such derived classes.

The class implements the common behaviour, specifically, the storage of the match pattern which is used to search for object names.

This class is not intended to be explicitly instantiated; it has public constructors but they are part of the class implementation and are described for information only.

Constructor & Destructor Documentation

TFindHandleBase ( )

IMPORT_CTFindHandleBase()

Default constructor.

The default constructed TFindHandleBase object has the default match pattern, i.e. the single character "*".

TFindHandleBase ( const TDesC & )

IMPORT_CTFindHandleBase(const TDesC &aMatch)

Constructor with match pattern.

This constructor creates a TFindHandleBase object with the specified match pattern.

ParameterDescription
aMatchA reference to the descriptor containing the match pattern.

Member Function Documentation

Find ( const TDesC & )

IMPORT_C voidFind(const TDesC &aMatch)

Sets a new match pattern.

On return from this function, this TFindHandleBase object contains a copy of the supplied match pattern; the source descriptor can, therefore, be safely discarded.

ParameterDescription
aMatchA reference to the descriptor containing the new match pattern.

NextObject ( TFullName &, TInt )

TInt NextObject(TFullName &aResult,
TIntaObjectType
)[protected]

Implementation for TFindXxxxxxx::Next(TFullName &aResult) methods