描述
该方法用于将数据从调用者提供的缓冲区写入开放的BLOB句柄。的numBytessv个字节的数据从缓冲区szBuffer复制到打开的BLOB中,从偏移量n偏移开始。
PB语法
METHOD BlobWrite ( _ BYVAL pDbc AS ISQLiteConnection, _ BYVAL pBuffer AS DWORD, _ BYVAL numBytes AS LONG, _ BYVAL nOffset AS LONG _ ) AS LONG |
参数
pDbc
[in] An ISQLiteConnection object.
pBuffer
[in]指向缓冲区的指针。
numBytes
[in]缓冲区的大小(以字节为单位)。
nOffset
[in]起始位置。如果偏移量n偏移从BLOB的末尾小于的numBytessv个字节,则返回SQLITE_ERROR,不会读取数据。如果的numBytessv或n偏移小于零,则返回SQLITE_ERROR,并且不会读取任何数据。可以使用BlobBytes函数确定blob的大小(从而numBytes + nOffset的最大值)。
返回值
SQLITE_OK成功;否则返回错误代码或扩展错误代码。
如果作为第一个参数传递的BLOB句柄未被打开以进行写入(flags参数为BlobOpen为零),则此函数返回SQLITE_READONLY。
备注
此函数只能修改BLOB的内容;使用该API不可能增加BLOB的大小。如果偏移量iOffset从BLOB的结尾小于N个字节,则返回SQLITE_ERROR,并且不会写入任何数据。如果N小于0,则返回SQLITE_ERROR,并且不会写入任何数据。可以使用BlobBytes函数确定BLOB的大小(因此numBytes + nOffset的最大值)。