勇芳软件工作室.汉化:  CSQLite Classes > CSQLiteStatement Class > ISQLiteStatement Interface >

BindBlob Method

Previous pageReturn to chapter overviewNext page

描述

 

用语句绑定一个blob。

 

PB语法

 

METHOD BindBlob ( _

BYVAL idx AS LONG _

BYVAL pValue AS DWORD, _

BYVAL numBytes AS LONG, _

BYVAL pDestructor AS DWORD _

) AS LONG

 

参数

 

idx

 

[in]要设置的SQL参数的索引。最左边的SQL参数的索引为1。当使用相同的命名SQL参数多次,第二次和后续出现与第一次出现相同的索引。如果需要,可以使用BindParameterIndex方法查找命名参数的索引。“?NNN”参数的索引是NNN的值。NNN值必须介于1和限制参数SQLITE_LIMIT_VARIABLE_NUMBER之间(默认值:999)。

 

pValue

 

[in]绑定到参数的值。

 

numBytes

 

[in]参数中的字节数。要清楚:值是值中的字节数,而不是字符数。

 

pDestructor

 

[in]一个用于在SQLite完成之后处理BLOB的析构函数。即使调用BindBlob失败,调用析构函数来处理BLOB。如果这个参数是特殊值SQLITE_STATIC,那么SQLite假定信息是静态的,非管理的空间,不需要被释放。如果此参数的值为SQLITE_TRANSIENT,那么在BindBlob函数返回之前,SQLite会立即自己创建数据的私有副本。

 

返回值

 

SQLITE_OK成功或错误代码如果出现问题。如果参数索引超出范围,则返回SQLITE_RANGE。如果的malloc失败,则返回SQLITE_NOMEM。

 

备注

 

如果BindBlob调用了准备语句的NULL指针,或者使用最近已经调用重启的准备语句,则调用将返回SQLITE_MISUSE。如果BindBlob被传递已经完成的准备语句,结果是未定义的,可能是有害的。

 

重启功能不会清除绑定。Unbound参数被解释为NULL。