ApLoadMessageDB()

Load a message database

Synopsis:

ApMsgDBase_t *ApLoadMessageDB( ApMsgDBase_t *db,
                               const char *name );

Library:

Ap

Description:

This function loads the message database with the given name. It searches for the file based on the value of the ABLPATH and the current language:

• If a language isn't defined, the message database is loaded. It must have a name of name.mdb.
• If a language is defined, ApLoadMessageDB() looks for a translation file called name.language. Translation files can be created using PhAB translation editor -- it can handle message databases.

The db argument is used if you want to add the messages from one database to another that's already open. This argument can be NULL.

Returns:

A pointer to the new database, or NULL if it couldn't be opened.

Classification:

Photon

See also:

AlClearTranslation(), AlCloseDBase(), AlGetEntry(), AlGetSize(), AlOpenDBase(), AlReadTranslation(), AlSaveTranslation(), AlSetEntry(), ApGetMessage()

International Language Support chapter of the Photon Programmer's Guide