EnumProjectsEx

4/8/2010

This function enumerates all projects in main memory or on the specified mountable file system, such as a flash card.

Syntax

int EnumProjectsEx(
  PROJECTS_ENUMPROC_EX pfnEnumProc, 
  DWORD dwOidFlash, 
  DWORD dwFlags, 
  LPARAM lParam 
);

Parameters

• pfnEnumProc
  [in] Pointer to the EnumProjectsExCallback callback function. If this pointer is set to NULL, this function returns only the number of projects, without enumerating them.

• dwOidFlash
  [in] Specifies the object identifier (OID) of the flash card to enumerate, which is the value returned by the FindFirstFlashCard or the FindNextFlashCard function. Used only when dwFlags equals PRJ_ENUM_FLASH.

• dwFlags
  [in] Specifies the valid flags. The following table shows possible values.

  Flag	Value	Description
  PRJ_ENUM_MEMORY	0x1	Enumerate folders in main memory only. The dwOidFlash parameter is ignored.
  PRJ_ENUM_FLASH	0x2	Enumerate a flash card project only. The dwOidFlash parameter is the object identifier of the flash card.
  PRJ_ENUM_ALL_DEVICES	0x4	Enumerate folders in main memory and on all flash cards. The dwOidFlash parameter is ignored.

• lParam
  [in] Caller-defined parameter that is passed to the callback function specified by pfnEnumProc.

Return Value

The number of folders enumerated indicates success. If there are no folders to enumerate, this function returns zero. If pfnEnumProc is set to NULL, this function still returns the total number of projects, including storage cards.

Remarks

To enumerate the folders on a flash card, first call the FindFirstFlashCard and the FindNextFlashCard functions to locate the OID of the flash card. After you have enumerated the folders with this function, enumerate the files with the EnumProjectsFilesEx function.

Requirements

See Also

Reference

File and Application Management Functions
EnumProjectsExCallback
EnumProjectsFilesEx
FindFirstFlashCard
FindNextFlashCard