Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

SHILCreateFromPath function

[SHILCreateFromPath is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Applications should use SHParseDisplayName instead]

Creates a pointer to an item identifier list (PIDL) from a path.

Syntax


HRESULT SHILCreateFromPath(
  _In_         PCWSTR pszPath,
  _Out_        PIDLIST_ABSOLUTE *ppidl,
  _Inout_opt_  DWORD *rgflnOut
);

Parameters

pszPath [in]

Type: PCWSTR

A pointer to a null-terminated string of maximum length MAX_PATH containing the path to be converted.

ppidl [out]

Type: PIDLIST_ABSOLUTE*

The path in pszPath expressed as a PIDL.

rgflnOut [in, out, optional]

Type: DWORD*

A pointer to a DWORD value that, on entry, indicates any attributes of the folder named in pszPath that the calling application would like to retrieve along with the PIDL. On exit, this value contains those requested attributes. For a list of possible attribute flags for this parameter, see IShellFolder::GetAttributesOf.

Return value

Type: HRESULT

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

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP with SP2

End of server support

Windows Server 2003

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.