IContentList::get_ActiveRows
.gif "Ee823913.c++_off(en-US,CS.10).gif")
.gif "Ee823913.vb_on(en-US,CS.10).gif")
The ActiveRows property returns a RowCollection object. This property is read-only; however, the RowCollection object is read/write. Changes made to the data within the RowCollection object are also reflected in the ContentList object.
Definition
Get method:
HRESULT IContentList::get_ActiveRows(IRowCollection**ActiveRows);
Parameters
ActiveRows
[out,retval] The address of a pointer used to return the IRowCollection interface of a RowCollection object that allows access the set of active items in this ContentList object.
Return Values
This method returns an HRESULT indicating whether or not it completed successfully. See the Error Values section for more details.
Error Values
This method returns S_OK (0x00000000) to indicate success and standard COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object, which can be accessed using the API function GetErrorInfo. In particular, the GetDescription method of the IErrorInfo interface may return a text description of the error.
Remarks
The ActiveRows RowCollection object allows access to the content items of the ContentList object whose score is greater than or equal to the current threshold score contained in the Threshold property. If the value of the Threshold property is set to a negative number, even items that have been filtered out by the Filter method might be included in the ActiveRows collection. This occurs because an item being filtered out has a score set to zero, which is still greater than a negative threshold value.
Regardless of the number of items with scores above the threshold, the number of items in the ActiveRows object is limited by the RowLimit property.
The order of the rows in the ActiveRows collection is undefined unless the Sorted property is set to True.