dsmGetData

在线编辑

dsmGetData 函数调用从 IBM® Storage Protect 获取数据的字节流，并将其放置在调用者的缓冲区中。 当要从先前的 dsmGetObj 或 dsmGetData 调用接收更多数据时，应用程序客户机将调用 dsmGetData 。

语法

dsInt16_t dsmGetData  (dsUint32_t   dsmHandle,
   DataBlk *dataBlkPtr);

参数

dsUint32_t dsmHandle (I)
将此调用与之前的 dsmInitEx 调用相关联的句柄。
DataBlk *dataBlkPtr (I/O)
指向一个结构，该结构包括指向已接收数据的缓冲区的指针和缓冲区大小。 返回时，此结构包含实际转移的字节数。 请参阅 API 类型定义源文件 以获取类型定义。

返回码

返回码编号用括号 ( ) 括起。

表 1. 返回代码为 dsmGetData
返回码 说明
DSM_RC_ABORT_INVALID_OFFSET (33) 部分对象检索期间指定的偏移量大于对象的长度。
DSM_RC_ABORT_INVALID_LENGTH (34) 部分对象检索期间指定的长度大于对象长度，或除长度以外的偏移量超出对象结尾。
DSM_RC_FINISHED (121) 已完成处理。 已收到最后一个缓冲区。 检查 numBytes 的数据量，然后调用 IBM Storage ProtectdsmEndGetObj。
DSM_RC_NULL_DATABLKPTR (2001) 数据块指针为空。
DSM_RC_ZERO_BUFLEN (2008) 针对数据块指针的缓冲区长度为零。
DSM_RC_NULL_BUFPTR (2009) 针对数据块指针的缓冲区指针为空。
DSM_RC_WRONG_VERSION_PARM (2065) 应用程序客户机的 API 版本与 IBM Storage Protect 库版本不同。
DSM_RC_MORE_DATA (2200) 还可获取更多数据。