描述
返回列值作为指向不受保护的sqlite3_value对象的指针。
PB语法
METHOD ColumnValue (BYVAL vCol AS LONG) AS DWORD |
参数
vCol
[in]应返回信息的列的索引或名称。结果集的最左列有索引0。结果中的列数可以使用ColumnCount确定。
返回值
列值作为指向不受保护的sqlite3_value对象的指针。
备注
如果SQL语句当前没有指向有效的行,或者如果列索引超出范围,则结果是未定义的。这些函数只能在最近调用步已返回SQLITE_ROW时调用,并且之后不再调用重启或最终确定.如果在重启或最终确定之后或在步返回了除了SQLITE_ROW之外的任何其他功能之后调用了这些函数,则结果未定义。步或重启或最终确定在sqlite3_value待处理之前从另一个线程调用,则结果未定义。
ColumnValue返回的对象是一个不受保护的sqlite3_value对象。不受保护的sqlite3_value对象只能与BindValue和ResultValue一起使用。如果以ColumnValue返回的未受保护的sqlite3_value对象以任何其他方式使用,包括对ValueLong,ValueText或ValueBytes等函数的调用,那么行为是未定义的。
如果在评估任何这些功能时发生内存分配错误,则返回默认值。默认值为NULL指针。对ErrCode的后续调用将返回SQLITE_NOMEM。