SHCreateItemFromIDList function

Creates and initializes a Shell item object from a pointer to an item identifier list (PIDL). The resulting shell item object supports the IShellItem interface.

Syntax

SHSTDAPI SHCreateItemFromIDList(
  PCIDLIST_ABSOLUTE pidl,
  REFIID            riid,
  void              **ppv
);

Parameters

pidl

Type: PCIDLIST_ABSOLUTE

The source PIDL.

riid

Type: REFIID

A reference to the IID of the requested interface.

ppv

Type: void**

When this function returns, contains the interface pointer requested in riid. This will typically be IShellItem or IShellItem2.

Return Value

Type: HRESULT

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

Requirements

   
Windows version Windows Vista [desktop apps only] Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll

See Also

SHGetIDListFromObject