SHCreateItemFromRelativeName-Funktion (shobjidl_core.h)

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