IEnumSearchScopeRules::Next Method

Retrieves the next given number of ISearchScopeRule elements.

Syntax

HRESULT Next(      
    ULONG celt,
    ISearchScopeRule **pprgelt,
    ULONG *pceltFetched
);

Parameters

  • celt
    [in]  The number of elements to retrieve.
  • pprgelt
    [out]  Returns a pointer to an array of ISearchScopeRule elements.
  • pceltFetched
    [in, out, unique]  Returns a pointer to the actual number of elements retrieved. May be NULL if celt == 1, otherwise it must be non-NULL.

Return Value

Returns S_OK if successful, S_FALSE if there were not enough items left in the enumeration to be returned, or an error value.

Remarks

Internally, this method updates a counter to move forward the number of elements actually fetched; subsequent calls to IEnumSearchScopeRules::Next will start from there.

pceltFetched may be NULL if celt == 1, otherwise pceltFetched must be non-NULL