SHCreateItemFromRelativeName-Funktion (shobjidl_core.h)

  • Artikel

Erstellt und initialisiert ein Shellelementobjekt aus einem relativen Analysenamen.

Syntax

SHSTDAPI SHCreateItemFromRelativeName(
  [in]  IShellItem *psiParent,
  [in]  PCWSTR     pszName,
  [in]  IBindCtx   *pbc,
  [in]  REFIID     riid,
  [out] void       **ppv
);

Parameter

[in] psiParent

Typ: IShellItem*

Ein Zeiger auf das übergeordnete Shellelement.

[in] pszName

Typ: PCWSTR

Ein Zeiger auf eine null-endende Unicode-Zeichenfolge, die einen Anzeigenamen angibt, der relativ zum psiParent ist.

[in] pbc

Typ: IBindCtx*

Ein Zeiger auf einen Bindungskontext, der den Analysevorgang steuert. Dieser Parameter kann NULL sein.

[in] riid

Typ: REFIID

Ein Verweis auf eine Schnittstellen-ID.

[out] ppv

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, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung Wert
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 (shobjidl.h einschließen)
DLL Shell32.dll
APIs ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)