Export (0) Print
Expand All
Expand Minimize

SHCloneSpecialIDList function

[SHCloneSpecialIDList is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use SHGetSpecialFolderLocation.]

Retrieves a pointer to the ITEMIDLIST structure that specifies a special folder.

Syntax


PIDLIST_ABSOLUTE SHCloneSpecialIDList(
  HWND hwndOwner,
  _In_  int csidl,
  _In_  BOOL fCreate
);

Parameters

hwndOwner

Type: HWND

Reserved.

csidl [in]

Type: int

A CSIDL value that identifies the folder of interest.

fCreate [in]

Type: BOOL

A value of type BOOL that indicates if the folder should be created if it does not already exist. If fCreate is TRUE, the folder is created. If it is FALSE, the folder is not created.

Return value

Type: PIDLIST_ABSOLUTE

Returns a pointer to the ITEMIDLIST structure of a special folder specified by csidl. The function creates the folder if fCreate is TRUE.

Remarks

When finished, you should free the pointer to the cloned folder with ILFree.

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

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

 

 

Community Additions

ADD
Show:
© 2014 Microsoft