Difference between revisions of "OpenDBX/C API/odbx unbind"

From Linuxnetworks
< OpenDBX‎ | C API
Jump to: navigation, search
(Description:)
(Description:)
Line 6: Line 6:
 
= Description: =
 
= Description: =
  
Releases the binding to the database and user for the connection. This is useful for switching to another database or binding to the database as a different user. It is also possible to set new connection related options before rebinding to the database server.
+
Releases the binding to the database and user for the connection opened by [[OpenDBX_bind_simple|odbx_bind_simple()]]. This is useful for switching to another database or binding to the database as a different user. It is also possible to set new connection related options before rebinding to the database server.
 +
 
 +
This function must be invoked before calling [[OpenDBX_finish|odbx_finish()]] to avoid memory leaks.
  
 
= Parameters: =
 
= Parameters: =

Revision as of 17:25, 5 June 2006


int odbx_unbind(
    odbx_t* handle ) 

Description:

Releases the binding to the database and user for the connection opened by odbx_bind_simple(). This is useful for switching to another database or binding to the database as a different user. It is also possible to set new connection related options before rebinding to the database server.

This function must be invoked before calling odbx_finish() to avoid memory leaks.

Parameters:

  • handle: Connection object created by odbx_init()

Return values:

  • Zero on success
  • Non-zero if an error occured

Errors:

  • -ODBX_ERR_PARAM: Parameter or its content is invalid



Back to Overview