勇芳软件工作室.汉化:  CSQLiteBlob Class > ISQLiteBlob Interface >

BlobWrite Method

Previous pageReturn to chapter overviewNext page

描述

 

该方法用于将数据从调用者提供的缓冲区写入开放的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,不会读取数据。如果的numBytessvn偏移小于零,则返回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的最大值)。