SHCreateItemWithParent-Funktion (shobjidl_core.h)

Erstellen Sie ein Shellelement mit einem übergeordneten Ordner und einer untergeordneten Element-ID.

Syntax

SHSTDAPI SHCreateItemWithParent(
  [in]  PCIDLIST_ABSOLUTE pidlParent,
  [in]  IShellFolder      *psfParent,
  [in]  PCUITEMID_CHILD   pidl,
  [in]  REFIID            riid,
  [out] void              **ppvItem
);

Parameter

[in] pidlParent

Typ: PCIDLIST_ABSOLUTE

Die IDList des übergeordneten Ordners des zu erstellenden Elements; die IDList von psfParent. Dieser Parameter kann NULL sein, wenn psfParent angegeben ist.

[in] psfParent

Typ: IShellFolder*

Ein Zeiger auf die IShellFolder-Schnittstelle , die die Shelldatenquelle des untergeordneten Elements angibt, das durch die pidl angegeben wird. Dieser Parameter kann NULL sein, wenn pidlParent angegeben ist.

[in] pidl

Typ: PCUITEMID_CHILD

Eine untergeordnete Element-ID relativ zum übergeordneten Ordner, der von psfParent oder pidlParent angegeben wird.

[in] riid

Typ: REFIID

Ein Verweis auf eine Schnittstellen-ID.

[out] ppvItem

Typ: void**

Wenn diese Funktion zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IShellItem oder IShellItem2.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
DLL	Shell32.dll