IShellFind::LaunchCustomOptions
4/8/2010
The LaunchCustomOptions method is called when the user taps the Options button in the Find application. It opens the custom Find Options dialog box for this type.
Syntax
HRESULT LaunchCustomOptions (
HWND hwndParent,
FINDITEMATTRIBUTES * pfia
);
Parameters
- hwndParent
[in] The parent window for the dialog box.
- pfia
[in, out] Parameters for the find.
Return Value
This method should return S_OK if it was successful or appropriate errors if not.
Remarks
When the user makes changes to options in the dialog box, members of pfia should be modified to reflect these changes in Find. In particular, the plug-in can use pvCustom to store information about parameters and then re-interpret these when the pfia value is passed to the StartFind method. This should be done on WM_COMMAND / IDOK when the dialog box is closed. In addition, changes to the parameters should be propagated to the registry so that the user changes will be remembered the next time the user launches Find. For example, the key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shell\Find\Extensions\{CLSID} might be a good place to store plug-in specific parameters.
Requirements
| Header | findext.h |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2000 and later |