描述
用语句绑定一个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。