Edit

Share via

SHSimpleIDListFromPath function (shobjidl_core.h)

  • Article

Deprecated. Returns a pointer to an ITEMIDLIST structure when passed a path.

Syntax

PIDLIST_ABSOLUTE SHSimpleIDListFromPath(
  [in] PCWSTR pszPath
);

Parameters

[in] pszPath

Type: PCWSTR

A pointer to a null-terminated string that contains the path to be converted to a PIDL.

Return value

Type: PIDLIST_ABSOLUTE

Returns a pointer to an ITEMIDLIST structure if successful, or NULL otherwise.

Remarks

Prior to Windows 7, this function was declared in Shlobj.h. In Windows 7 and later versions, it is declared in Shobjidl.h.

Note  This function is available through Windows 7 and Windows Server 2003. It is possible that it will not be present in future versions of Windows.
 
An alternative to this function is as follows:
  1. Call SHGetDesktopFolder to obtain IShellFolder for the desktop folder.
  2. Get the IShellFolder's bind context (IBindCtx).
  3. Call IShellFolder::ParseDisplayName with the IBindCtx and the path.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
Library Shell32.lib
DLL Shell32.dll (version 5.00 or later)
API set ext-ms-win-shell-shell32-l1-2-1 (introduced in Windows 10, version 10.0.10240)