IShellFindCallback::OnFindProgress
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 |