IEnumSearchScopeRules::Next Method

  • Article

Retrieves the specified number of ISearchScopeRule elements.

Syntax

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

Parameters

  • celt
    [in] The number of elements to retrieve.
  • pprgelt
    [out] On return, contains a pointer to an array of ISearchScopeRule elements.
  • pceltFetched
    [in, out, unique] On return, contains a pointer to the actual number of elements retrieved. Can be NULL if celt == 1, otherwise it must not be 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 retrieved; subsequent calls to IEnumSearchScopeRules::Next will start from that number.

Windows 7 and later: the CrawlScopeCommandLine code sample, available on Code Gallery and the Windows 7 SDK, demonstrates how to define command line options for Crawl Scope Manager (CSM) indexing operations.