Contents|Index|Previous|Next

Bookmark C Data Type

The bookmark C data type allows an application to retrieve a bookmark. The bookmark C types are used only to retrieve bookmark values that can be variable in length; they should not be converted to other data types. An application retrieves a bookmark either from column 0 of the result set with SQLBulkOperations (with an operation of SQL_ADD), SQLFetch, SQLFetchScroll, or SQLGetData. For more information, see Bookmarks in Chapter 11, Retrieving Results (Advanced).

The following table lists the value of CType for the bookmark C data type, the ODBC C data type that implements the bookmark C data type, and the definition of this data type from SQL.H.

Note The SQL_C_BOOKMARK data type has been deprecated. ODBC 3.0 applications should not use SQL_C_BOOKMARK. ODBC 3.0 drivers need to support SQL_C_BOOKMARK only if they want to work with ODBC 2.x applications that use it. The Driver Manager maps SQL_C_VARBOOKMARK to SQL_C_BOOKMARK when an application works with an ODBC 2.x driver.

C type identifier
ODBC C typedef
C type



SQL_C_BOOKMARK
(Deprecated)
BOOKMARK
unsigned long int



SQL_C_VARBOOKMARK
SQLCHAR *
unsigned char *