FolderListCreate()

Creates a folder list.

Token ID

AFTKN_FLDRLIST_CREATE or 704

Syntax

DWORD FolderListCreate(ENUM Contents; 
                        [ANSISTRING UserID])

Parameters

Contents As ENUM

Create a folder list including all folders, no folders, or only the root folder. If you create an Empty! folder list, call FolderListAddFolder() before passing the folder list handle to ItemListCreate. Specify as follows:

7

All

150

Empty

216

Root
UserID As ANSISTRINGA

(Optional) User ID (root folder).

Return Values

  • DWORD. Folder list handle if successful, 0 if not.

Remarks

IMPORTANT: Delete a folder list handle when it is no longer needed, or system resources will be lost. (See FolderListDelete.)