接收方变量

在线编辑

接收方变量 是一个程序变量，用作输出字段以包含从检索 API 返回的信息。

检索 API 使用接收方变量而不是用户空间来放置返回的信息。 检索 API 只需要对固定大小的存储器 (通常是程序中定义的字段或结构) 具有可寻址性。 相比较而言，列表 API 需要用户空间，因为列表 API 返回的信息量可能很大，并且不是可预测的大小。

使用为接收方变量参数提供的存储器检索将信息返回到接收方变量的 API。 返回的信息采用特定格式。 格式名称通常是调用 API 时的参数，格式向 API 指示要返回的信息。 在从调用返回到 API 时，调用者通过接收方变量进行解析并抽取所需的信息。 调用者知道信息的记录格式是如何返回信息的。 API 可能具有一种或多种格式，使您能够灵活地选择所需的信息。

有些格式有变长字段，有些格式只有定长字段，有些格式有重复条目。 要在信息中移动，某些格式使用偏移量，某些使用长度和某些使用位移。 当该字段定义为偏移量时，偏移量始终是从接收器变量开始的字节数。 当使用长度或位移来移动接收器变量条目时，该长度始终被添加到接收器变量中的当前位置。

偏移量和位移不相同。 offset 相对于接收器变量的开头或用户空间的开头，而 位移 相对于指针的当前位置加上位移字段中的值。 如果格式使用位移，那么您将在 API 描述的 "字段" 列中看到单词 位移 。