SHCreateItemFromRelativeName function (shobjidl_core.h)

Creates and initializes a Shell item object from a relative parsing name.

Syntax

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

Parameters

[in] psiParent

Type: IShellItem*

A pointer to the parent Shell item.

[in] pszName

Type: PCWSTR

A pointer to a null-terminated, Unicode string that specifies a display name that is relative to the psiParent.

[in] pbc

Type: IBindCtx*

A pointer to a bind context that controls the parsing operation. This parameter can be NULL.

[in] riid

Type: REFIID

A reference to an interface ID.

[out] ppv

Type: void**

When this function returns, contains the interface pointer requested in riid. This will usually be IShellItem or IShellItem2.

Return value

Type: HRESULT

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll
API set ext-ms-win-shell-shell32-l1-2-2 (introduced in Windows 10, version 10.0.14393)