IEnumContextProps::Next 方法 (objidl.h)
擷取列舉序列中指定的項目數目。
語法
HRESULT Next(
[in] ULONG celt,
[out] ContextProperty *pContextProperties,
[out] ULONG *pceltFetched
);
參數
[in] celt
要擷取的項目數。 如果序列中剩餘的項目數目少於所要求的項目數,這個方法會擷取其餘的專案。
[out] pContextProperties
列舉項目的陣列。
列舉值負責配置任何記憶體,而呼叫端負責釋放它。 如果 celt 大於 1,呼叫端也必須傳遞傳遞至 pceltFetched 的非 NULL 指標,以瞭解要釋放的指標數目。
[out] pceltFetched
已擷取的項目數。 此參數一律小於或等於所要求的項目數目。
傳回值
如果方法擷取所要求的項目數,傳回值會S_OK。 否則,它會S_FALSE。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | objidl.h (包含 ObjIdl.h) |