This method retrieves the specified number of items in the enumeration sequence.
HRESULT IVIO_EnumDiagnosticEntry::Next ( ULONG cItems, IVIO_DataValue **rgItemsArray, ULONG *pcItemsFetched);
One of the values described in the following table is returned.
Value |
Description |
S_OK | The application successfully retrieved the number of IVIO_DataValue interfaces specified in cItems. The value referenced by pcItemsFetched is set to cItems. |
S_FALSE | The application returned fewer IVIO_DataValue interfaces than specified in Items. The value referenced by pcItemsFetched is set to the number of interfaces returned. The members of rgItemsArray that were not set are set to NULL. |
E_OUTOFMEMORY | The application is out of memory. |
E_UNEXPECTED | An unexpected error occurred. |
E_INVALIDARG | The value of cItems is invalid, or pcItemsFetched is NULL and cItems is greater than 1. |
E_POINTER | Either the rgItemsArray pointer is invalid or the pcItemsFetched pointer is invalid. |
The application must release the interfaces returned in rgItemsArray when it is done with them.