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 |
|
|
Library |
|
|
DLL |
|