SHCreateShellItem-Funktion (shlobj_core.h)

2023-08-26

Hinweis Es wird empfohlen, shCreateItemWithParent oder SHCreateItemFromIDList anstelle dieser Funktion zu verwenden.

Syntax

SHSTDAPI SHCreateShellItem(
  [in, optional] PCIDLIST_ABSOLUTE pidlParent,
  [in, optional] IShellFolder      *psfParent,
  [in]           PCUITEMID_CHILD   pidl,
  [out]          IShellItem        **ppsi
);

Parameter

[in, optional] pidlParent

Typ: PCIDLIST_ABSOLUTE

Eine PIDL für das übergeordnete Element. Dieser Wert kann NULL sein.

[in, optional] psfParent

Typ: IShellFolder*

Ein Zeiger auf den übergeordneten IShellFolder. Dieser Wert kann NULL sein.

[in] pidl

Typ: PCUITEMID_CHILD

Eine PIDL für das angeforderte Element. Wenn übergeordnete Informationen nicht in pidlParent oder psfParent enthalten sind, muss dies eine absolute PIDL sein.

[out] ppsi

Typ: IShellItem**

Wenn diese Methode zurückgibt, enthält den Schnittstellenzeiger auf das neue IShellItem.

Rückgabewert

Typ: HRESULT

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

Hinweise

SHCreateShellItem erstellt ein -Objekt, das ein Shell-Namespaceelement darstellt. Der Anrufer muss übergeordnete Informationen in pidlParent oder psfParent angeben; Alternativ kann der Aufrufer eine absolute IDList im pidl-Parameter angeben.

Es gibt drei gültige Aufrufmuster für diese Funktion:

Der übergeordnete Ordner wird durch eine absolute IDList pidlParent identifiziert. Der pidl-Parameter verweist auf eine untergeordnete IDList, die das Element innerhalb des Ordners identifiziert, der durch pidlParent identifiziert wird.
```
IShellItem *psi;
SHCreateShellItem(pidlParent, NULL, pidlChild, &psi);
```
Der übergeordnete Ordner wird durch psfParent identifiziert. Der pidl-Parameter verweist auf eine untergeordnete IDList, die das Element innerhalb des Ordners identifiziert, der durch psfParent identifiziert wird.
```
IShellItem *psi;
SHCreateShellItem(NULL, psfParent, pidlChild, &psi);
```
Das Element wird durch eine absolute IDList identifiziert, die an den pidl-Parameter übergeben wird.
```
IShellItem *psi;
SHCreateShellItem(NULL, NULL, pidlFull, &psi);
```

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (shlobj.h einschließen)
Bibliothek	Shell32.lib
DLL	Shell32.dll
APIs	ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)