dev_Initialize()

Initialize the library with the name of the device database.

#include "device.h"

LResult dev_Initialize
    (
        LFileName    database
    );

dev_Initialize() establishes the device database to use for subsequent calls to dev_New(). If this function is not called before calling dev_New(), the default database will be used.

If successful, dev_Initialize() returns a non-negative value. Otherwise, it returns a negative value indicating the reason it failed. Possible unsuccessful return values are:

• dev_ERROR_CANNOT_OPEN_DATABASE
• dev_ERROR_OUT_OF_MEMORY

dev_IsInitialized()
dev_Uninitialized()

if ((result = dev_Initialize("default.db")) < 0)
{
    LOG("Initialization failure: ", dev_ErrorMessage(result));
    exit(EXIT_FAILURE);
}