Export (0) Print
Expand All
Expand Minimize

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:
© 2014 Microsoft