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 |
|
|
Library |
|
|
DLL |
|