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