continuation handle（连续句柄）

在线编辑

当调用 API 时，如果 API 要返回的信息多于接收方变量或用户空间中可容纳的信息，那么 API 将返回一个连续句柄，该句柄用于标记在接收方变量或用户空间中放入的最后一个值。

如果由于要返回更多信息而向调用者返回了延续句柄，那么调用者可以再次调用 API 并传递返回的延续句柄。 API 将继续从它在生成延续句柄的调用上留下的位置返回信息。

当您使用连续句柄参数时，这是唯一可以更改的参数。 所有其他参数必须与它们在调用生成了延续句柄的 API 时一样显示，以获取可预测的结果。

要使用连续句柄，请执行以下步骤:

  1. 将连续句柄留空，以让 API 知道这是首次尝试执行检索操作。
  2. 调用 API 以检索信息。
  3. 使用返回的信息。
  4. 如果接收器变量中的连续句柄字段未设置为空白，请执行以下步骤，直到连续句柄等于空白为止:
    1. 将连续句柄从接收器变量复制到连续句柄参数。
    2. 使用返回的延续句柄再次调用 API。 使所有其他参数与原始 API 调用中的参数相同。