This topic has not yet been rated - Rate this topic

ILCombine function

Applies to: desktop apps only

Combines two ITEMIDLIST structures.

Syntax

PIDLIST_ABSOLUTE ILCombine(
  __in  PCIDLIST_ABSOLUTE pidl1,
  __in  PCUIDLIST_RELATIVE pidl2
);

Parameters

pidl1 [in]

Type: PCIDLIST_ABSOLUTE

A pointer to the first ITEMIDLIST structure.

pidl2 [in]

Type: PCUIDLIST_RELATIVE

A pointer to the second ITEMIDLIST structure. This structure is appended to the structure pointed to by pidl1.

Return value

Type: PIDLIST_ABSOLUTE

Returns an ITEMIDLIST containing the combined structures. If you set either pidl1 or pidl2 to NULL, the returned ITEMIDLIST structure is a clone of the non-NULL parameter. Returns NULL if pidl1 and pidl2 are both set to NULL.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Freeing the memory
You should mention that we must free the returned pidl with ILFree