IKnownFolderManager::FindFolderFromPath method

Gets an object that represents a known folder based on a file system path. The object allows you to query certain folder properties, get the current path of the folder, redirect the folder to another location, and get the path of the folder as an ITEMIDLIST.

Syntax

HRESULT FindFolderFromPath(
  LPCWSTR      pszPath,
  FFFP_MODE    mode,
  IKnownFolder **ppkf
);

Parameters

pszPath

Type: LPCWSTR

Pointer to a null-terminated Unicode string of length MAX_PATH that contains a path to a known folder.

mode

Type: FFFP_MODE

One of the following values that specify the precision of the match of path and known folder:

FFFP_EXACTMATCH

Retrieve only the specific known folder for the given file path.

FFFP_NEARESTPARENTMATCH

If an exact match is not found for the given file path, retrieve the first known folder that matches one of its parent folders walking up the parent tree.

ppkf

Type: IKnownFolder**

When this method returns, contains the address of a pointer to the IKnownFolder object that represents the known folder.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll

See also

IKnownFolderManager

Known Folders Sample