SHGetRealIDL function (shlobj_core.h)

[SHGetRealIDL is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Converts a simple pointer to an item identifier list (PIDL) into a full PIDL.

Syntax

SHSTDAPI SHGetRealIDL(
  [in]  IShellFolder    *psf,
  [in]  PCUITEMID_CHILD pidlSimple,
  [out] PITEMID_CHILD   *ppidlReal
);

Parameters

[in] psf

Type: IShellFolder*

A pointer to an instance of IShellFolder whose simple PIDL is to be converted.

[in] pidlSimple

Type: PCUITEMID_CHILD

The simple PIDL to be converted.

[out] ppidlReal

Type: PITEMID_CHILD*

When this method returns, contains a pointer to the full converted PIDL. If the function fails, this parameter is set to NULL.

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 XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (version 5.0 or later)
API set ext-ms-win-shell-shell32-l1-2-2 (introduced in Windows 10, version 10.0.14393)