SHCreateItemFromRelativeName-Funktion (shobjidl_core.h)

Erstellt und initialisiert ein Shell-Elementobjekt aus einem relativen Analysenamen.

Syntax

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

Die Parameter

[in] psiParent

Typ: IShellItem*

Ein Zeiger auf das übergeordnete Shellelement.

[in] pszName

Typ: PCWSTR-

Ein Zeiger auf eine mit Null beendete 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ückgegeben wird, enthält sie 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 HRESULT-Fehlercode zurückgegeben.

Anforderungen