HPosLmDatabaseInfo Class Reference

API published in: S60 3rd Ed

Link against: eposlmdbmanlib.lib

Capability Information

Required Capabilities

None

Exceptions

The capability ReadUserData is required in:

CPosLmDatabaseManager::NewL();

CPosLmDatabaseManager::DefaultDatabaseUriLC();

CPosLmDatabaseManager::NotifyDatabaseEvent( TPosLmDatabaseEvent & aEvent, TRequestStatus & aStatus );

CPosLmDatabaseManager::DatabaseUriFromLastEventLC();

CPosLmDatabaseManager::ListDatabasesLC( const TDesC & aProtocol = KNullDesC );

CPosLmDatabaseManager::ListDatabasesL( RPointerArray< HPosLmDatabaseInfo > & aDatabaseInfoArray, const TDesC & aProtocol = KNullDesC );

CPosLmDatabaseManager::RegisterDatabaseL( HPosLmDatabaseInfo & aDatabaseInfo );

CPosLmDatabaseManager::UnregisterDatabaseL( const TDesC & aDatabaseUri );

CPosLmDatabaseManager::UnregisterAllDatabasesL( const TDesC & aProtocol );

CPosLmDatabaseManager::ModifyDatabaseSettingsL( const TDesC & aDatabaseUri, const TPosLmDatabaseSettings & aDatabaseSettings );

CPosLmDatabaseManager::GetDatabaseInfoL( HPosLmDatabaseInfo & aDatabaseInfo );

CPosLmDatabaseManager::DatabaseExistsL( const TDesC & aDatabaseUri );

CPosLmDatabaseManager::CreateDatabaseL( HPosLmDatabaseInfo & aDatabaseInfo );

CPosLmDatabaseManager::DeleteDatabaseL( const TDesC & aDatabaseUri );

CPosLmDatabaseManager::CopyDatabaseL( const TDesC & aSourceUri, const TDesC & aTargetUri );

The capability WriteUserData is required in:

CPosLmDatabaseManager::RegisterDatabaseL( HPosLmDatabaseInfo & aDatabaseInfo );

CPosLmDatabaseManager::UnregisterDatabaseL( const TDesC & aDatabaseUri );

CPosLmDatabaseManager::UnregisterAllDatabasesL( const TDesC & aProtocol );

CPosLmDatabaseManager::ModifyDatabaseSettingsL( const TDesC & aDatabaseUri, const TPosLmDatabaseSettings & aDatabaseSettings );

CPosLmDatabaseManager::CreateDatabaseL( HPosLmDatabaseInfo & aDatabaseInfo );

CPosLmDatabaseManager::DeleteDatabaseL( const TDesC & aDatabaseUri );

CPosLmDatabaseManager::CopyDatabaseL( const TDesC & aSourceUri, const TDesC & aTargetUri );

The capability WriteDeviceData is required in:

CPosLmDatabaseManager::SetDefaultDatabaseUriL( const TDesC & aDatabaseUri );

The capability NetworkServices is required in:

CPosLmDatabaseManager::DatabaseExistsL( const TDesC & aDatabaseUri ); When database URI refers to remote database.

CPosLmDatabaseManager::CreateDatabaseL( HPosLmDatabaseInfo & aDatabaseInfo ); When database URI refers to remote database.

CPosLmDatabaseManager::DeleteDatabaseL( const TDesC & aDatabaseUri ); When database URI refers to remote database.

CPosLmDatabaseManager::CopyDatabaseL( const TDesC & aSourceUri, const TDesC & aTargetUri ); When any of database URIs refers to remote database.

Other Information

The capability NetworkServices is required to work with remote databases.

#include <epos_hposlmdatabaseinfo.h>

Detailed Description

HPosLmDatabaseInfo encapsulates information about a landmark database.

Public Member Functions

IMPORT_C TPtrC DatabaseUri () const
 Retrieves the database URI.
IMPORT_C TPtrC Protocol () const
 Returns the protocol part from the URI which is set.
IMPORT_C TBool IsDefault () const
 Returns whether the database is the default database.
IMPORT_C TMediaType DatabaseMedia () const
 Returns which storage media the database resides in.
IMPORT_C TChar DatabaseDrive () const
 Returns which database drive the database resides in.
IMPORT_C const TPosLmDatabaseSettings & Settings () const
 Retrieve a const reference to the database settings.
IMPORT_C TPosLmDatabaseSettings & Settings ()
 Retrieve a reference to the database settings.
IMPORT_C TInt Size () const
 Returns the size in bytes of this object.
void SetDefault (TBool aIsDefault)
void SetMediaType (TMediaType aMediaType)
void SetDatabaseDrive (TChar aDatabaseDrive)

Static Public Member Functions

static IMPORT_C HPosLmDatabaseInfo * NewLC (const TDesC &aDatabaseUri)
 Two-phased constructor.
static IMPORT_C HPosLmDatabaseInfo * NewL (const TDesC &aDatabaseUri)
 Two-phased constructor.
static IMPORT_C HPosLmDatabaseInfo * NewLC (const HPosLmDatabaseInfo &aDatabaseInfo)
 Two-phased copy constructor.
static IMPORT_C HPosLmDatabaseInfo * NewL (const HPosLmDatabaseInfo &aDatabaseInfo)
 Two-phased copy constructor.

Member Function Documentation

IMPORT_C TChar HPosLmDatabaseInfo::DatabaseDrive (   )  const
 

Returns which database drive the database resides in.

Note: that this attribute is only set if the HPosLmDatabaseInfo instance has been returned from a CPosLmDatabaseManager function, e.g. CPosLmDatabaseManager::ListDatabasesL, CPosLmDatabaseManager::GetDatabaseInfoL, CPosLmDatabaseManager::RegisterDatabaseL, CPosLmDatabaseManager::CreateDatabaseL or CPosLmDatabaseManager::ModifyDatabaseSettingsL. If not, this function returns 0.

If database drive is not applicable for the database, e.g. the database is remote, this function returns 0.

Returns:
The drive letter for the drive where the database resides, or 0 if the letter is not set.
IMPORT_C TMediaType HPosLmDatabaseInfo::DatabaseMedia (   )  const
 

Returns which storage media the database resides in.

Note: this attribute is only set if the HPosLmDatabaseInfo instance has been returned from a CPosLmDatabaseManager function, e.g. CPosLmDatabaseManager::ListDatabasesL, CPosLmDatabaseManager::GetDatabaseInfoL, CPosLmDatabaseManager::RegisterDatabaseL, CPosLmDatabaseManager::CreateDatabaseL or CPosLmDatabaseManager::ModifyDatabaseSettingsL. If not, this function returns EMediaUnknown.

Returns:
The storage media the database resides in.
IMPORT_C TPtrC HPosLmDatabaseInfo::DatabaseUri (   )  const
 

Retrieves the database URI.

Returns:
A pointer to the URI descriptor. This pointer is valid until the HPosLmDatabaseInfo object is destroyed.
IMPORT_C TBool HPosLmDatabaseInfo::IsDefault (   )  const
 

Returns whether the database is the default database.

Note: that this attribute is only set if the HPosLmDatabaseInfo instance has been returned from a CPosLmDatabaseManager function, e.g. CPosLmDatabaseManager::ListDatabasesL, CPosLmDatabaseManager::GetDatabaseInfoL, CPosLmDatabaseManager::RegisterDatabaseL, CPosLmDatabaseManager::CreateDatabaseL or CPosLmDatabaseManager::ModifyDatabaseSettingsL. If not, this function returns EFalse.

Returns:
ETrue if the database is the default one, otherwise EFalse.
static IMPORT_C HPosLmDatabaseInfo* HPosLmDatabaseInfo::NewL ( const HPosLmDatabaseInfo &  aDatabaseInfo  )  [static]
 

Two-phased copy constructor.

Parameters:
[in] aDatabaseInfo The information instance to copy.
Returns:
A new instance of this class.
static IMPORT_C HPosLmDatabaseInfo* HPosLmDatabaseInfo::NewL ( const TDesC &  aDatabaseUri  )  [static]
 

Two-phased constructor.

Parameters:
[in] aDatabaseUri The URI of the landmark database.
Returns:
A new instance of this class.
static IMPORT_C HPosLmDatabaseInfo* HPosLmDatabaseInfo::NewLC ( const HPosLmDatabaseInfo &  aDatabaseInfo  )  [static]
 

Two-phased copy constructor.

Parameters:
[in] aDatabaseInfo The information instance to copy.
Returns:
A new instance of this class.
static IMPORT_C HPosLmDatabaseInfo* HPosLmDatabaseInfo::NewLC ( const TDesC &  aDatabaseUri  )  [static]
 

Two-phased constructor.

Parameters:
[in] aDatabaseUri The URI of the landmark database.
Returns:
A new instance of this class.
IMPORT_C TPtrC HPosLmDatabaseInfo::Protocol (   )  const
 

Returns the protocol part from the URI which is set.

Example: If the URI is "file://c:landmarks.ldb" then the protocol is "file".

If no protocol is specified, an empty descriptor is returned. This implies "file" protocol.

Returns:
A pointer to the protocol descriptor. This pointer is valid until the HPosLmDatabaseInfo object is destroyed.
void HPosLmDatabaseInfo::SetDatabaseDrive ( TChar  aDatabaseDrive  ) 
 
void HPosLmDatabaseInfo::SetDefault ( TBool  aIsDefault  ) 
 
void HPosLmDatabaseInfo::SetMediaType ( TMediaType  aMediaType  ) 
 
IMPORT_C TPosLmDatabaseSettings& HPosLmDatabaseInfo::Settings (   ) 
 

Retrieve a reference to the database settings.

The reference can be used to read and write to the database settings.

Returns:
Reference to the database settings
IMPORT_C const TPosLmDatabaseSettings& HPosLmDatabaseInfo::Settings (   )  const
 

Retrieve a const reference to the database settings.

The const reference can be used to read the database settings.

Returns:
Const reference to the database settings
IMPORT_C TInt HPosLmDatabaseInfo::Size (   )  const
 

Returns the size in bytes of this object.

Returns:
The size of this object.
The documentation for this class was generated from the following file:
Copyright © Nokia Corporation 2001-2008
Back to top