dsmGetNextQObj

参数

dsUint32_t dsmHandle (I)

将此调用与之前的 dsmInitEx 调用相关联的句柄。

DataBlk *dataBlkPtr (I/O)

指向包括用于要接收的数据的缓冲区的指针和缓冲区大小的结构。 该缓冲区是 qryResp*Data 响应结构。 返回时，此结构包含转移的字节数。 下表中描述了与每个查询类型相关联的结构。 有关 DataBlk的类型定义的更多信息，请参阅以下主题: API 类型定义源文件。

表 1. DataBlk 指针结构

查询	响应结构	特别注意的字段
qtArchive	qryRespArchiveData	sizeEstimate 包含在先前的 dsmSendObj 调用上传递的值。 mediaClass 如果对象位于磁盘上，那么值可以为 MEDIA_FIXED，或者如果对象位于磁带上，那么值可以为 MEDIA_LIBRARY。 clientDeduplicated 指示客户机是否对此对象进行重复数删除。
qtBackup	qryRespBackupData	restoreOrderExt 类型为 dsUint16_t。 在 dsmBeginGetData 调用上复原多个对象时，对此字段进行排序。 API 示例中提供对此调用的代码进行排序的示例，dapiqry.c。 有关排序示例，请参阅以下主题: 图 1。 sizeEstimate 包含在先前的 dsmSendObj 调用上传递的值。 mediaClass 如果对象位于磁盘上，那么值可以为 MEDIA_FIXED，或者如果对象位于磁带上，那么值可以为 MEDIA_LIBRARY。 clientDeduplicated 指示客户机是否对此对象进行重复数删除。
qtBackupActive	qryARespBackupData
qtBackupGroups	qryRespBackupData	dsBool_t isGroupLeader 如果为 true，那么表明此对象是组引导符。
qtOpenGroups	qryRespBackupData	dsBool_t isOpenGroup; 如果为 true，那么表明此组已打开且未完成。
qtFilespace	qryRespFSData	backStartDate 包含使用 backStartDate 操作更新文件空间时的服务器时间戳记。 backCompleteDate 包含使用 backCompleteDate 操作更新文件空间时的服务器时间戳记。 lastReplStartDate 包含上次在服务器上启动复制的时间戳记。 lastReplCmpltDate 包含上次完成复制的时间戳记，即使存在故障。 lastBackOpDateFromServer 包含上次在服务器上进行保存的存储时间戳记。 lastBackOpDateFromLocal 包含上次在客户机上进行保存的存储时间戳记。
qtMC	qryRespMCData qryRespMCDetailData
qtProxyNodeAuth	qryRespProxyNodeData targetNodeName peerNodeName hlAddress llAddress
qtProxyNodePeer	qryRespProaxyNodeData targetNodeName peerNodeName hlAddress llAddress

返回码

下表描述了 dsmGetNextQObj 函数调用的返回码。