IEnumConnections::Next 方法 (ocidl.h)
擷取列舉序列中指定的項目數目。
語法
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 (查看陣列中每個專案的 pUnk 成員 CONNECTDATA) 。 如果 cConnections 大於一,則呼叫端也必須將非 NULL 指標傳遞至 lpcFetched ,以取得必須釋放的指標數目。
E_NOTIMPL不允許作為傳回值。 如果傳回錯誤值,則陣列中沒有任何項目在結束時有效,因此不需要釋放。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | ocidl.h (包含 ObjIdl.h) |