Export (0) Print
Expand All
Expand Minimize

SHCreateItemWithParent function

Create a Shell item, given a parent folder and a child item ID.

Syntax


HRESULT SHCreateItemWithParent(
  _In_   PCIDLIST_ABSOLUTE pidlParent,
  _In_   IShellFolder *psfParent,
  _In_   PCUITEMID_CHILD pidl,
  _In_   REFIID riid,
  _Out_  void **ppvItem
);

Parameters

pidlParent [in]

Type: PCIDLIST_ABSOLUTE

The IDList of the parent folder of the psfParent.This parameter can be NULL, if psfParent is specified.

psfParent [in]

Type: IShellFolder*

A pointer to IShellFolder interface that specifies the shell data source of the child item specified by the pidl.This parameter can be NULL, if pidlParent is specified.

pidl [in]

Type: PCUITEMID_CHILD

A child item ID relative to its parent folder specified by psfParent or pidlParent.

riid [in]

Type: REFIID

A reference to an interface ID.

ppvItem [out]

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

DLL

Shell32.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft