SHGetRealIDL function

[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(
  IShellFolder    *psf,
  PCUITEMID_CHILD pidlSimple,
  PITEMID_CHILD   *ppidlReal
);

Parameters

psf

Type: IShellFolder*

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

pidlSimple

Type: PCUITEMID_CHILD

The simple PIDL to be converted.

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

   
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)