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

See Also

Reference

IShellFind
FINDITEMATTRIBUTES
IShellFind::StartFind