描述
用语句绑定文本值。
PB语法
METHOD BindText ( _ BYVAL idx AS LONG _ BYVAL strValue AS STRING, _ BYVAL numBytes AS LONG, _ OPTIONAL BYVAL pDestructor AS DWORD _ ) AS LONG |
参数
idx
[in]要设置的SQL参数的索引。最左边的SQL参数的索引为1。当使用相同的命名SQL参数多次，第二次和后续出现与第一次出现相同的索引。如果需要，可以使用BindParameterIndex方法查找命名参数的索引。“？NNN”参数的索引是NNN的值。NNN值必须介于1和限制参数SQLITE_LIMIT_VARIABLE_NUMBER之间（默认值：999）。
strValue
[in]绑定到参数的值。
numBytes
[in]参数中的字节数。要清楚：值是值中的字节数，而不是字符数。如果该值为负，则字符串的长度是直到第一个零终止符的字节数。如果BindText或BindTextW提供非负值，则该参数必须是NUL终止符发生的字节偏移，假设字符串NUL终止。如果任何NUL字符出现在小于第四个参数的值的字节偏移量上，则生成的字符串值将包含嵌入的NUL。涉及嵌入NUL的字符串的表达式的结果是未定义的。
pDestructor
[in]用于在SQLite完成之后处理字符串的析构函数。即使调用BindBlob失败，调用析构函数来处理字符串。如果这个参数是特殊值SQLITE_STATIC，则SQLite假定信息在静态的非管理空间中，不需要被释放。如果此参数的值为SQLITE_TRANSIENT，那么在BindBlob函数返回之前，SQLite将立即自己创建数据的私有副本。
返回值
SQLITE_OK成功或错误代码如果出现问题。如果参数索引超出范围，则返回SQLITE_RANGE。如果的malloc失败，则返回SQLITE_NOMEM。
备注
如果BindText调用了准备语句的NULL指针，或者调用了比重启更近调用了步的准备语句，则调用将返回SQLITE_MISUSE。如果BindText传递已经完成的准备语句，则结果是未定义的，可能是有害的。
绑定不会被重启功能清除。Unbound参数被解释为NULL。