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) |