IEnumOleDocumentViews::Next 方法 (docobj.h)
检索枚举序列中指定数量的项。
语法
HRESULT Next(
[in] ULONG cViews,
[out] IOleDocumentView **rgpView,
[in, out] ULONG *pcFetched
);
参数
[in] cViews
要检索的项数。 如果序列中剩余的项数少于请求的项数,此方法将检索剩余的元素。
如果 pcFetched 为 NULL,则此参数必须为 1。
[out] rgpView
枚举项的数组。
枚举器负责调用 AddRef,调用方负责通过枚举的每个指针调用 Release 。 如果 cViews 大于 1,则调用方还必须传递传递给 pcFetched 的非 NULL 指针,以了解要释放的指针数。
[in, out] pcFetched
检索到的项数。 此参数始终小于或等于请求的项数。 此参数可以为 NULL,在这种情况下, cViews 参数必须为 1。
返回值
如果 方法检索请求的项数,则返回值S_OK。 否则,它将S_FALSE。
注解
不允许将E_NOTIMPL作为返回值。 如果返回错误值,则 rgpView 数组中没有任何条目有效,并且无需调用 Release。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | docobj.h |