MimerBeginSessionC

Starts a session with the database. (char version.)

Parameters

int32_t MimerBeginSessionC (

            const char *database,

            const char *ident,

            const char *password,

            MimerSession *sessionhandle)

database

in

The name of the database to connect to. If this is null, a connection to the default database is created.

ident

in

The ident associated with the session to create. This parameter may not be null.

password

in

The password of the ident. A null value is identical to a zero length password. Database servers which do not enforce authentication control may ignore the password.

sessionhandle

out

A session handle identifying the session when calling MimerEndSession, MimerBeginStatement, MimerBeginStatement8, MimerBeginTransaction, MimerExecuteStatement, MimerExecuteStatement8, MimerExecuteStatementC and MimerEndTransaction.

Returns

A negative value indicating an error, or zero if successful.

Return value

Description

MIMER_SUCCESS

Success.

MIMER_OUTOFMEMORY

Out of memory.

MIMER_ILLEGAL_CHARACTER

One of the string parameters database, ident or password contained an illegal character.

< 0

Any of the server error codes listed in Return Codes.

Notes

This routine interacts with the database server.

A session handle may or may not have been returned. MimerEndSession should therefore always be called to avoid handle leaks.

Micro API compatible.

char version of the routine. See Character String Formats for more information about character formats and the different routine versions.