TFindLibrary Class Reference

#include <e32std.h>

class TFindLibrary : public TFindHandleBase

Inherits from

Detailed 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().

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

Constructor & Destructor Documentation

TFindLibrary ( )

TFindLibrary()[inline]

Constructs this object with a default match pattern.

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

TFindLibrary ( const TDesC & )

TFindLibrary(const TDesC &aMatch)[inline]

Constructs this object with the specified match pattern.

ParameterDescription
aMatchThe descriptor containing the match pattern.

Member Function Documentation

Next ( TFullName & )

IMPORT_C TIntNext(TFullName &aResult)

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.

ParameterDescription
aResultA 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.

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