SHGetPathFromIDListA function

Converts an item identifier list to a file system path.

Syntax

BOOL SHGetPathFromIDListA(
  PCIDLIST_ABSOLUTE pidl,
  LPSTR             pszPath
);

Parameters

pidl

Type: PCIDLIST_ABSOLUTE

The address of an item identifier list that specifies a file or directory location relative to the root of the namespace (the desktop).

pszPath

Type: LPTSTR

The address of a buffer to receive the file system path. This buffer must be at least MAX_PATH characters in size.

Return Value

Type: BOOL

Returns TRUE if successful; otherwise, FALSE.

Remarks

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

If the pidl parameter specifies a shortcut, the pszPath will contain the path to the shortcut, not to the shortcut's target.

Requirements

   
Windows version Windows XP [desktop apps only] Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h, Shlobj_core.h)
Library Shell32.lib
DLL Shell32.dll (version 4.0 or later)

See Also

SHGetPathFromIDListEx

SHParseDisplayName