IShellFolderViewType::TranslateViewPidl method

Reconstructs a pointer to an item identifier list (PIDL) from one hierarchical representation of the Shell folder into a different representation.

Syntax

HRESULT TranslateViewPidl(
  [in] PCUIDLIST_RELATIVE pidl,
  [in] PCUIDLIST_RELATIVE pidlView,
  [in] PCUIDLIST_RELATIVE *ppidlOut
);

Parameters

pidl [in]

Type: PCUIDLIST_RELATIVE

The array of item IDs relative to the root folder.

pidlView [in]

Type: PCUIDLIST_RELATIVE

Special PIDL of the view.

ppidlOut [in]

Type: PCUIDLIST_RELATIVE*

The address of a PIDL variable to receive the translation.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

When finished, you should free the returned PIDL with ILFree.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
DLL
Shell32.dll