Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The LaunchCustomOptionsmethod is called when the user taps the Optionsbutton in the Findapplication. It opens the custom Find  Optionsdialog 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_OKif it was successful or appropriate errors if not.

Remarks

When the user makes changes to options in the dialog box, members of pfiashould be modified to reflect these changes in Find. In particular, the plug-in can use pvCustomto store information about parameters and then re-interpret these when the pfiavalue is passed to the StartFindmethod. This should be done on WM_COMMAND/ IDOKwhen 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

See Also