IShellLinkA::SetIDList method

Sets the pointer to an item identifier list (PIDL) for a Shell link object.

Syntax

HRESULT SetIDList(
  PCIDLIST_ABSOLUTE pidl
);

Parameters

pidl

Type: PCIDLIST_ABSOLUTE

The object's fully qualified PIDL.

Return Value

Type: HRESULT

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

Remarks

This method is useful when an application needs to set a Shell link to an object that is not a file, such as a Control Panel application, a printer, or another computer.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h
DLL Shell32.dll (version 4.0 or later)