Collapse all Symbian^3 Application Developer Library

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

TFindHandleBase
- TFindHandle

Public Member Functions
	TFindHandleBase ()
	TFindHandleBase (const TDesC &)
IMPORT_C void	Find (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_C

TFindHandleBase

(

)

Default constructor.

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

TFindHandleBase(const TDesC &)

IMPORT_C

TFindHandleBase

(

const TDesC &

aMatch

)

Constructor with match pattern.

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

Parameters

const TDesC & aMatch

A reference to the descriptor containing the match pattern.

Member Functions Documentation

Find(const TDesC &)

IMPORT_C void

Find

(

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 & aMatch

A reference to the descriptor containing the new match pattern.

NextObject(TFullName &, TInt)

TInt	NextObject	(	TFullName &	aResult,
			TInt	aObjectType
		)	[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.