IEnumConnections：：Next 方法 （ocidl.h）

检索枚举序列中的指定项数。 项对应于 CONNECTDATA 结构。

Syntax

HRESULT Next(
  [in]  ULONG         cConnections,
  [out] LPCONNECTDATA rgcd,
  [out] ULONG         *pcFetched
);

参数

[in] cConnections

要检索的项数。 如果序列中剩余的项数少于所请求的项数，此方法将检索其余元素。

[out] rgcd

枚举项的数组。

枚举器负责分配任何内存，调用方负责释放它。 如果 celt 大于 1，调用方还必须传递传递给 pceltFetched 的非 NULL 指针，以了解要释放的指针数。

[out] pcFetched

检索到的项的数量。 此参数始终小于或等于所请求的项数。

返回值

如果该方法检索请求的项数，则返回值S_OK。 否则，它S_FALSE。

注解

此方法成功返回后，调用方负责为数组中的每个元素调用 Release（请参阅 CONNECTDATA 的 pUnk 成员）。 如果 cConnections 大于 1，则调用方还必须将非 NULL 指针传递给 lpcFetched 以获取必须释放的指针数。

不允许将E_NOTIMPL作为返回值。 如果返回错误值，则数组中没有条目在退出时有效，因此不需要释放。

要求

另请参阅

CONNECTDATA

IEnumConnections