智能大对象的状态信息有对应的客户机函数。
下表描述状态信息和对应的客户机函数。
磁盘存储信息
描述
客户机函数
最后访问时刻
最后访问智能大对象的时刻，以秒计。
仅当为智能大对象设置
LO_KEEP_LASTACCESS_TIME 标志
时，此值才可用。
ifx_lo_stat_atime()
状态更改的最后时
刻
智能大对象最后状态更改的时刻，以秒
计。
状态的更改包括所有权更改和引用数更
改。
ifx_lo_stat_ctime()
最后修改时刻（秒）
最后修改智能大对象的时刻，以秒计。 ifx_lo_stat_mtime_sec()
最后修改时刻（微
秒）
最后修改时刻的微秒组件。
仅在提供微秒级系统时间的平台上支持
此值。
ifx_lo_stat_mtime_usec()
引用计数
对智能大对象应用数的计数。
ifx_lo_stat_refcnt()
大小
以字节计的智能大对象的大小。
ifx_lo_stat_size()
这些时刻值（诸如最后访问时刻和最后更改时刻）可能与系统时刻略有差异。此差异是由
于数据库服务器从操作系统获取时刻的算法导致的。
检索关于智能大对象的信息的示例
代码示例 loinfo.c 展示如何检索关于智能大对象的信息。
在 UNIX™ 平台上的 %GBS_HOME%/demo/clidemo 目录中，以及在 Windows™ 环境中
的 %GBS_HOME%\demo\odbcdemo 目录中，可找到 loinfo.c 文件。在同一位置，还可找
到关于如何构建 odbc_demo 数据库的指导。
/*
** loinfo.c
**
** To check the status of a smart large object
**
** OBDC Functions:
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 122 -
** SQLBindCol
** SQLBindParameter
** SQLConnect
** SQLFetch
** SQLFreeStmt
** SQLDisconnect
** SQLExecDirect
*/
#include
#include
#include
#ifndef NO_WIN32
#include
#include
#include
#endif /*NO_WIN32*/
#include "infxcli.h"
#define BUFFER_LEN 20
#define ERRMSG_LEN 200
UCHAR defDsn[] = "odbc_demo";
int checkError (SQLRETURN rc,
SQLSMALLINT handleType,
SQLHANDLE handle,
char *errmsg)
{
SQLRETURN retcode = SQL_SUCCESS;
SQLSMALLINT errNum = 1;
SQLCHAR sqlState[6];
SQLINTEGER nativeError;
SQLCHAR errMsg[ERRMSG_LEN];
SQLSMALLINT textLengthPtr;
if ((rc != SQL_SUCCESS) && (rc != SQL_SUCCESS_WITH_INFO))
{
while (retcode != SQL_NO_DATA)
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 123 -
{
retcode = SQLGetDiagRec (handleType, handle, errNum, sqlState,
&nativeError, errMsg, ERRMSG_LEN, &textLengthPtr);
if (retcode == SQL_INVALID_HANDLE)
{
fprintf (stderr, "checkError function was called with an
invalid handle!!\n");
return 1;
}
if ((retcode == SQL_SUCCESS) || (retcode ==
SQL_SUCCESS_WITH_INFO))
fprintf (stderr, "ERROR: %d: %s : %s \n", nativeError,
sqlState, errMsg);
errNum++;
}
fprintf (stderr, "%s\n", errmsg);
return 1; /* all errors on this handle have been reported */
}
else
return 0; /* no errors to report */
}
int main (long argc,
char *argv[])
{
/* Declare variables
*/
/* Handles */
SQLHDBC hdbc;
SQLHENV henv;
SQLHSTMT hstmt;
/* Smart large object file descriptor */
long lofd;
long lofd_valsize = 0;
/* Smart large object specification structure */
char* lospec_buffer;
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 124 -
short lospec_size;
long lospec_valsize = 0;
/* Smart large object status structure */
char* lostat_buffer;
short lostat_size;
long lostat_valsize = 0;
/* Smart large object pointer structure */
char* loptr_buffer;
short loptr_size;
long loptr_valsize = 0;
/* Miscellaneous variables */
UCHAR dsn[20]; /*name of the DSN used for connecting to the
database*/
SQLRETURN rc = 0;
int in;
char* selectStmt = "SELECT advert FROM item WHERE item_num =
1004";
long lo_size;
long mode = LO_RDONLY;
char sbspace_name[BUFFER_LEN];
long sbspace_name_size = SQL_NTS;
long cbMode = 0, cbLoSize = 0;
/* STEP 1. Get data source name from command line (or use default).
** Allocate the environment handle and set ODBC version.
** Allocate the connection handle.
** Establish the database connection.
** Allocate the statement handle.
*/
/* If (dsn is not explicitly passed in as arg) */
if (argc != 2)
{
/* Use default dsn - odbc_demo */
fprintf (stdout, "\nUsing default DSN : %s\n", defDsn);
strcpy ((char *)dsn, (char *)defDsn);
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 125 -
}
else
{
/* Use specified dsn */
strcpy ((char *)dsn, (char *)argv[1]);
fprintf (stdout, "\nUsing specified DSN : %s\n", dsn);
}
/* Allocate the Environment handle */
rc = SQLAllocHandle (SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);
if (rc != SQL_SUCCESS)
{
fprintf (stdout, "Environment Handle Allocation
failed\nExiting!!\n");
return (1);
}
/* Set the ODBC version to 3.5 */
rc = SQLSetEnvAttr (henv, SQL_ATTR_ODBC_VERSION,
(SQLPOINTER)SQL_OV_ODBC3, 0);
if (checkError (rc, SQL_HANDLE_ENV, henv, "Error in Step 1 --
SQLSetEnvAttr failed\nExiting!!\n"))
return (1);
/* Allocate the connection handle */
rc = SQLAllocHandle (SQL_HANDLE_DBC, henv, &hdbc);
if (checkError (rc, SQL_HANDLE_ENV, henv, "Error in Step 1 -- Connection
Handle Allocation failed\nExiting!!\n"))
return (1);
/* Establish the database connection */
rc = SQLConnect (hdbc, dsn, SQL_NTS, "", SQL_NTS, "", SQL_NTS);
if (checkError (rc, SQL_HANDLE_DBC, hdbc, "Error in Step 1 -- SQLConnect
failed\nExiting!!"))
return (1);
/* Allocate the statement handle */
rc = SQLAllocHandle (SQL_HANDLE_STMT, hdbc, &hstmt );
if (checkError (rc, SQL_HANDLE_DBC, hdbc, "Error in Step 1 -- Statement
Handle Allocation failed\nExiting!!"))
return (1);
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 126 -
fprintf (stdout, "STEP 1 done...connected to database\n");
/* STEP 2. Select a smart-large object from the database.
** -- the select statement executed is -
** "SELECT advert FROM item WHERE item_num = 1004"
*/
/* Execute the select statement */
rc = SQLExecDirect (hstmt, selectStmt, SQL_NTS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 2 --
SQLExecDirect failed\n"))
goto Exit;
fprintf (stdout, "STEP 2 done...select statement executed...smart large
object retrieved from the databse\n");
/* STEP 3. Get the size of the smart large object pointer structure.
** Allocate a buffer to hold the structure.
** Get the smart large object pointer structure from the database.
** Close the result set cursor.
*/
/* Get the size of the smart large object pointer structure */
rc = SQLGetInfo (hdbc, SQL_INFX_LO_PTR_LENGTH, &loptr_size,
sizeof(loptr_size), NULL);
if (checkError (rc, SQL_HANDLE_DBC, hdbc, "Error in Step 3 -- SQLGetInfo
failed\n"))
goto Exit;
/* Allocate a buffer to hold the smart large object pointer structure */
loptr_buffer = malloc (loptr_size);
/* Bind the smart large object pointer structure buffer allocated to the
column in the result set & fetch it from the database */
rc = SQLBindCol (hstmt, 1, SQL_C_BINARY, loptr_buffer, loptr_size,
&loptr_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 3 --
SQLBindCol failed\n"))
goto Exit;
rc = SQLFetch (hstmt);
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 127 -
if (rc == SQL_NO_DATA_FOUND)
{
fprintf (stdout, "No Data Found\nExiting!!\n");
goto Exit;
}
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 3 -- SQLFetch
failed\n"))
goto Exit;
/* Close the result set cursor */
rc = SQLCloseCursor (hstmt);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 3 --
SQLCloseCursor failed\n"))
goto Exit;
fprintf (stdout, "STEP 3 done...smart large object pointer structure
fetched from the database\n");
/* STEP 4. Use the smart large object's pointer structure to open it
** and obtain the smart large object file descriptor.
** Reset the statement parameters.
*/
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_OUTPUT, SQL_C_LONG,
SQL_INTEGER, (UDWORD)0, 0, &lofd, sizeof(lofd), &lofd_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 4 --
SQLBindParameter failed (param 1)\n"))
goto Exit;
rc = SQLBindParameter (hstmt, 2, SQL_PARAM_INPUT, SQL_C_BINARY,
SQL_INFX_UDT_FIXED, (UDWORD)loptr_size, 0, loptr_buffer,
loptr_size, &loptr_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 4 --
SQLBindParameter failed (param 2)\n"))
goto Exit;
rc = SQLBindParameter (hstmt, 3, SQL_PARAM_INPUT, SQL_C_LONG,
SQL_INTEGER, (UDWORD)0, 0, &mode, sizeof(mode), &cbMode);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 4 --
SQLBindParameter failed (param 3)\n"))
goto Exit;
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 128 -
rc = SQLExecDirect (hstmt, "{? = call ifx_lo_open(?, ?)}", SQL_NTS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 4 --
SQLExecDirect failed\n"))
goto Exit;
/* Reset the statement parameters */
rc = SQLFreeStmt (hstmt, SQL_RESET_PARAMS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 4 --
SQLFreeStmt failed\n"))
goto Exit;
fprintf (stdout, "STEP 4 done...smart large object opened... file
descriptor obtained\n");
/* STEP 5. Get the size of the smart large object status structure.
** Allocate a buffer to hold the structure.
** Get the smart large object status structure from the database.
** Reset the statement parameters.
*/
/* Get the size of the smart large object status structure */
rc = SQLGetInfo (hdbc, SQL_INFX_LO_STAT_LENGTH, &lostat_size,
sizeof(lostat_size), NULL);
if (checkError (rc, SQL_HANDLE_DBC, hdbc, "Error in Step 5 -- SQLGetInfo
failed\n"))
goto Exit;
/* Allocate a buffer to hold the smart large object status structure. */
lostat_buffer = malloc(lostat_size);
/* Get the smart large object status structure from the database. */
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_LONG,
SQL_INTEGER, (UDWORD)0, 0, &lofd, sizeof(lofd), &lofd_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 5 --
SQLBindParameter failed (param 1)\n"))
goto Exit;
rc = SQLBindParameter (hstmt, 2, SQL_PARAM_INPUT_OUTPUT,
SQL_C_BINARY,
SQL_INFX_UDT_FIXED, (UDWORD)lostat_size, 0, lostat_buffer,
lostat_size, &lostat_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 5 --
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 129 -
SQLBindParameter failed (param 2)\n"))
goto Exit;
rc = SQLExecDirect (hstmt, "{call ifx_lo_stat(?, ?)}", SQL_NTS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 5 --
SQLExecDirect failed\n"))
goto Exit;
/* Reset the statement parameters */
rc = SQLFreeStmt (hstmt, SQL_RESET_PARAMS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 5 --
SQLFreeStmt failed\n"))
goto Exit;
fprintf (stdout, "STEP 5 done...smart large object status structure
fetched from the database\n");
/* STEP 6. Use the smart large object's status structure to get the size
** of the smart large object.
** Reset the statement parameters.
** You can use additional ifx_lo_stat_*() functions to get more
** status information about the samrt large object.
** You can also use it to retrieve the smart large object
** specification structure and get further information about the
** smart large objectusing it's specification structure.
*/
/* Use the smart large object status structure to get the size of the
smart large object. */
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_BINARY,
SQL_INFX_UDT_FIXED, (UDWORD)lostat_size, 0, lostat_buffer,
lostat_size, &lostat_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 6 --
SQLBindParameter failed (param 1)\n"))
goto Exit;
rc = SQLBindParameter (hstmt, 2, SQL_PARAM_OUTPUT, SQL_C_LONG,
SQL_BIGINT, (UDWORD)0, 0, &lo_size, sizeof(lo_size), &cbLoSize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 6 --
SQLBindParameter failed (param 1)\n"))
goto Exit;
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 130 -
rc = SQLExecDirect (hstmt, "{call ifx_lo_stat_size(?, ?)}", SQL_NTS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 6 --
SQLExecDirect failed\n"))
goto Exit;
/* Reset the statement parameters */
rc = SQLFreeStmt (hstmt, SQL_RESET_PARAMS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 6 --
SQLFreeStmt failed\n"))
goto Exit;
fprintf (stdout, "LARGE OBJECT SIZE = %ld\n", lo_size);
fprintf (stdout, "STEP 6 done...smart large object size retrieved\n");
/* STEP 7. Get the size of the smart large object specification structure.
** Allocate a buffer to hold the structure.
** Get the smart large object specification structure from the
** database.
** Reset the statement parameters.
*/
/* Get the size of the smart large object specification structure */
rc = SQLGetInfo (hdbc, SQL_INFX_LO_SPEC_LENGTH, &lospec_size,
sizeof(lospec_size), NULL);
if (checkError (rc, SQL_HANDLE_DBC, hdbc, "Error in Step 7 -- SQLGetInfo
failed\n"))
goto Exit;
/* Allocate a buffer to hold the smart large object specification
structure */
lospec_buffer = malloc (lospec_size);
/* Get the smart large object specification structure from the
database */
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_BINARY,
SQL_INFX_UDT_FIXED, (UDWORD)lostat_size, 0, lostat_buffer,
lostat_size, &lostat_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 7 --
SQLBindParameter failed (param 1)\n"))
goto Exit;
rc = SQLBindParameter (hstmt, 2, SQL_PARAM_OUTPUT, SQL_C_BINARY,
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 131 -
SQL_INFX_UDT_FIXED, (UDWORD)lospec_size, 0, lospec_buffer,
lospec_size, &lospec_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 7 --
SQLBindParameter failed (param 2)\n"))
goto Exit;
rc = SQLExecDirect (hstmt, "{call ifx_lo_stat_cspec(?, ?)}", SQL_NTS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 7 --
SQLExecDirect failed\n"))
goto Exit;
fprintf (stdout, "STEP 7 done...smart large object status structure
fetched from the database\n");
/* STEP 8. Use the smart large object's specification structure to get
** the sbspace name where the smart large object is stored.
** Reset the statement parameters.
*/
/* Use the smart large object's specification structure to get the
sbspace name of the smart large object. */
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_BINARY,
SQL_INFX_UDT_FIXED, (UDWORD)lospec_size, 0, lospec_buffer,
lospec_size, &lospec_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 8 --
SQLBindParameter failed (param 1)\n"))
goto Exit;
rc = SQLBindParameter (hstmt, 2, SQL_PARAM_OUTPUT, SQL_C_CHAR,
SQL_CHAR,
BUFFER_LEN, 0, sbspace_name, BUFFER_LEN, &sbspace_name_size);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 8 --
SQLBindParameter failed (param 2)\n"))
goto Exit;
rc = SQLExecDirect (hstmt, "{call ifx_lo_specget_sbspace(?, ?)}",
SQL_NTS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 8 --
SQLExecDirect failed\n"))
goto Exit;
fprintf (stdout, "LARGE OBJECT SBSPACE NAME = %s\n", sbspace_name);
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 132 -
fprintf (stdout, "STEP 8 done...large object sbspace name retrieved\n");
/* STEP 9. Close the smart large object.
*/
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_LONG,
SQL_INTEGER, (UDWORD)0, 0, &lofd, sizeof(lofd), &lofd_valsize);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 9 --
SQLBindParameter failed\n"))
goto Exit;
rc = SQLExecDirect (hstmt, "{call ifx_lo_close(?)}", SQL_NTS);
if (checkError (rc, SQL_HANDLE_STMT, hstmt, "Error in Step 9 --
SQLExecDirect failed\n"))
goto Exit;
fprintf (stdout, "STEP 9 done...smart large object closed\n");
/* STEP 10.Free the allocated buffers.
*/
free (loptr_buffer);
free (lostat_buffer);
free (lospec_buffer);
fprintf (stdout, "STEP 10 done...smart large object buffers freed\n");
Exit:
/* CLEANUP: Close the statement handle.
** Free the statement handle.
** Disconnect from the datasource.
** Free the connection and environment handles.
** Exit.
*/
/* Close the statement handle */
SQLFreeStmt (hstmt, SQL_CLOSE);
/* Free the statement handle */
GBase 8s ODBC Driver 程序员指南
南大通用数据技术股份有限公司
- 133 -
SQLFreeHandle (SQL_HANDLE_STMT, hstmt);
/* Disconnect from the data source */
SQLDisconnect (hdbc);
/* Free the environment handle and the database connection handle */
SQLFreeHandle (SQL_HANDLE_DBC, hdbc);
SQLFreeHandle (SQL_HANDLE_ENV, henv);
fprintf (stdout,"\n\nHit to terminate the program...\n\n");
in = getchar ();
return (rc);
}