Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
SHGetRealIDL
Collapse the table of content
Expand the table of content

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


HRESULT SHGetRealIDL(
  _In_  IShellFolder    *psf,
  _In_  PCUITEMID_CHILD pidlSimple,
  _Out_ PITEMID_CHILD   *ppidlReal
);

Parameters

psf [in]

Type: IShellFolder*

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

pidlSimple [in]

Type: PCUITEMID_CHILD

The simple PIDL to be converted.

ppidlReal [out]

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]

End of client support

Windows XP with SP2

End of server support

Windows Server 2003

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

 

 

Community Additions

ADD
Show:
© 2015 Microsoft