C++ Syntax

__int32

MKI_DatabaseGetIndex(

const LPCWSTR f_pszDatabaseName );

Determines the index of a database with the given name.

Parameters

DatabaseName

[const LPCWSTR] Name of the database whose index in to be determined. If DatabaseName begins with MKI_CHAR_SYSTEM, the following name specifies an internal database, otherwise an external database is specified.

Return Value Changed in Version 6.60

The index of an external database (value between 0 and MKI_DATABASE_MAX - 1) or a value between MKI_BLOCK_INDEX and MKI_BLOCK_INDEX + MKI_DATABASE_INTERNAL_MAX - 1 indicating an internal database if successful, otherwise a negative value.

Comment

To access an internal database, DatabaseName must begin with MKI_CHAR_SYSTEM, followed by the internal database's name. "*" refers to the default internal database (with empty name), whereas "*Data" refers to the internal database with the name "Data".

To access an external database, DatabaseName must contain the database name without a preceding MKI_CHAR_SYSTEM. "Data" refers to the external database "Data".