Partager via

IShellFindCallback::OnFindProgress

  • Article

4/8/2010

The OnFindProgress method provides notification of items that were found during a search.

Syntax

HRESULT OnFindProgress (
  DWORD dwPercent,
  int cNewItems,
  IshellFindItem ** prgpisfiNew
);

Parameters

  • dwPercent
    [in] Percentage of the search that is complete; must be between 0 and 100 inclusive.
  • cNewItems
    [in] Number of new items that match.
  • prgpisfiNew
    [in] Reference to an array of interface pointers for the new matching items.

Return Value

This method should return S_OK if it was successful, and appropriate errors if not.

Remarks

As the find proceeds, the DLL should call the OnFindProgress method to pass matching items back to Find. When all items have been found, the DLL should call OnFindProgress with dwPercent equal to 100. Each subsequent call to the OnFindProgress method should report items that have not been previously reported.

Note

If a find is aborted with a call to the IShellFind::AbortFind method, the handler must call the OnFindProgress method, with dwPercent equal to 100, in the callback to signify that it has acknowledged the abort request.

Requirements

Header findext.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later

See Also

Reference

IShellFindCallback
IShellFind::AbortFind