SHGetIDListFromObject function (shobjidl_core.h)

Retrieves the pointer to an item identifier list (PIDL) of an object.

Syntax

SHSTDAPI SHGetIDListFromObject(
  [in]  IUnknown         *punk,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Parameters

[in] punk

Type: IUnknown*

A pointer to the IUnknown of the object from which to get the PIDL.

[out] ppidl

Type: PIDLIST_ABSOLUTE*

When this function returns, contains a pointer to the PIDL of the given object.

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 Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll

See also

SHCreateItemFromIDList