Class TFindLibrary

class TFindLibrary : public TFindHandleBase;

Description

Searches for DLLs whose full names match a specified pattern.

The match pattern is set at construction but can also be changed at any time after construction by using TFindHandleBase::Find(const TDesC &).

After construction, use TFindLibrary::Next(TFullName &) to repeatedly find successive DLLs whose names match the current pattern. A successful call to TFindLibrary::Next(TFullName &) means that a matching DLL has been found.

Derivation

• TFindHandle - No description.

• TFindHandleBase - Base class for searching for global kernel objects.

• TFindLibrary - Searches for DLLs whose full names match a specified pattern.

Members

Defined in TFindLibrary:

• Next(TFullName &)Finds the next DLL whose full name matches the match pattern.
• TFindLibrary()Constructs this object with a default match pattern.
• TFindLibrary(const TDesC &)Constructs this object with the specified match pattern.

Inherited from TFindHandleBase:

• Find(const TDesC &)Sets a new match pattern.
• TFindHandleBase(const TDesC &)Constructor with match pattern.

inline TFindLibrary();

Description

Constructs this object with a default match pattern.

The default match pattern is the single character ‘*’ and is implemented by the base class TFindHandleBase.

inline TFindLibrary(const TDesC &aMatch);

Description

Constructs this object with the specified match pattern.

Parameters

const TDesC16 &aMatch The descriptor containing the match pattern.

IMPORT_C TInt Next(TFullName &aResult);

Description

Finds the next DLL whose full name matches the match pattern.

If a DLL with a matching name is found, the function copies the full name of the DLL into the descriptor aResult.

Parameters

TBuf &aResult A buffer for the fullname of the DLL. This is a template specialisation of TBuf defining a modifiable buffer descriptor taking a maximum length of KMaxFullName. If no matching DLL is found, the descriptor length is set to zero.

Return value

TInt KErrNone, if a matching DLL is found; KErrNotFound, otherwise.