Edit

Share via

SHFindFiles function (shlobj_core.h)

  • Article

[SHFindFiles is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Displays the Search window UI.

Syntax

BOOL SHFindFiles(
  [in, optional] PCIDLIST_ABSOLUTE pidlFolder,
  [in, optional] PCIDLIST_ABSOLUTE pidlSaveFile
);

Parameters

[in, optional] pidlFolder

Type: PCIDLIST_ABSOLUTE

The folder from which to start the search. This folder appears in the Look in: box in the Search window. This folder and all of its subfolders are searched unless users choose other options in the Search window's More Advanced Options. This value can be NULL.

[in, optional] pidlSaveFile

Type: PCIDLIST_ABSOLUTE

This parameter is not used and must be set to NULL.

Windows Server 2003 and Windows XP:  A saved search file (.fnd) to load. You can save search parameters to a .fnd file after the search is begun. This value can be NULL.

Return value

Type: BOOL

Returns TRUE if successful in displaying the Search window; otherwise FALSE.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (version 6.0 or later)