Revision as of 14:34, 5 June 2006

int odbx_bind_simple(
    odbx_t* handle,
    const char* database,
    const char* username,
    const char* password ) 

Description:

Opens the database located on the database server specified in odbx_init(). The authentication is done by using the given username and password which may be NULL if they are not used by the backend. If any options should be set, it must be done before calling this function.

Parameters:

• handle: Connection object created by odbx_init()
• database: Name of the database
• username: User to connect to the database
• password: Password string for authentication

Return values:

• Zero on success
• Less than zero if an error occured

Errors:

• -ODBX_ERR_BACKEND: Any error occured in the backend
• -ODBX_ERR_PARAM: One of the parameters is NULL or handle is invalid
• -ODBX_ERR_NOMEM: Allocating new memory failed
• -ODBX_ERR_TOOLONG: The length of a string exceeded the buffer size

Back to Overview