lld_write() 函数

此函数用于从当前位置开始将数据写入打开的大对象。

语法

mi_integer lld_write (conn, io, buffer, bytes, error)
      MI_CONNECTION*                conn;
      LLD_IO*                       io;
      void*                         buffer;
      mi_integer                    bytes;
   mi_integer*                   error; 

int lld_write (LLD_IO* io, void* buffer, 
                        int bytes, int* error); 

conn

先前通过调用 mi_open() 或 mi_server_connect() 函数建立的连接描述符。 此参数仅适用于 API 接口。在此函数的 ESQL/C 和 SQL 版本中，您必须已经连接到服务器。

io

指向先前通过调用 lld_open() 函数创建的 LLD_IO 结构的指针。

buffer

指向从中写入数据的缓冲区的指针。该缓冲区的大小不得低于 bytes 参数中指定的字节数。

字节

要写入的字节数。

error

函数在其中返回错误代码的输出参数。

用途

调用此函数之前，必须通过调用 lld_open() 打开大对象并设置 LLD_WRONLY 或 LLD_RDWR 标志。lld_write() 函数将从当前位置开始进行写入。缺省情况下，打开大对象时，当前位置即为对象的开始位置。可以调用 lld_seek() 以更改当前位置。

如果要将数据附加到对象，请在打开对象时指定 LLD_APPEND 标志，以便将当前位置设置为对象的结束位置。如果已经执行了此操作，并且已经打开对象以进行读写，那么仍然可以使用 lld_seek 在对象中移动和读取不同的位置。但是，只要开始写入，当前位置都将移到对象的结束位置，以保证不会覆盖任何现有数据。

返回码

如果成功，lld_write() 函数将返回它所写入的字节数。

如果失败，对于 API 函数，将返回 MI_ERROR；而对于 ESQL/C 函数，将返回 -1。

上下文

lld_open() 函数

lld_seek() 函数

lld_tell() 函数