TFindHandleBase Class Reference

class TFindHandleBase : public TFindHandle

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.

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()
Private Attributes
TFullName iMatch

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.

Parameters

const TDesC & aMatchA reference to the descriptor containing the match pattern.

Member Functions 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.

Parameters

const TDesC & 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

Parameters

TFullName & aResult
TInt aObjectType

Member Data Documentation

TFullName iMatch

TFullName iMatch[private]

The full name of the last kernel side object found.