Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

SHSimpleIDListFromPath function

Applies to: desktop apps only

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

Syntax

Copy 
PIDLIST_ABSOLUTE SHSimpleIDListFromPath(
  __in  PCWSTR pszPath
);

Parameters

pszPath [in]

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

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header
Shobjidl.h

Library
Shell32.lib

DLL
Shell32.dll (version 5.00 or later)

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
This API will be supported in the future
Please remove the part about deprecation
History
See this SDK sample for a more complete way to do what this API does
The Windows 7 SDK sample Parsing With Parameters Sample

http://msdn.microsoft.com/en-us/library/dd940368(VS.85).aspx
History