IEnumSearchRoots::Next Method

Retrieves the specified number of ISearchRoot elements.

Syntax

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

Parameters

  • celt
    [in] The number of elements to retrieve.
  • pprgelt
    [out] Retrieves a pointer to an array of ISearchRoot elements.
  • pceltFetched
    [in, out, unique] Retrieves 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 otherwise.

Remarks

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.