SHGetPathFromIDList

This function converts an item identifier list to a file system path.

At a Glance

Header file: Shellapi.h (Shlobj.h for Palm-size PC and HPC)
Windows CE versions: 2.0 and later

Syntax

WINSHELLAPI BOOL WINAPI SHGetPathFromIDList( LPCITEMIDLIST pidl, LPSTR pszPath );

Parameters

pidl

[in] Pointer to an item identifier list that specifies a file or directory location relative to the root of the namespace (the desktop).

pszPath

[out] Pointer to a buffer to receive the file system path. This buffer must be at least MAX_PATH characters in size.

Return Values

TRUE indicates success. FALSE indicates failure.

Remarks

If the location specified by the pidl parameter is not part of the file system, this function will fail.