EnumProjectsEx

Article
08/28/2006

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

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, EnumProjectsEx returns only the number of projects, without enumerating through them.
dwOidFlash
[in] Specifies the object identifier (OID) of the flash card to enumerate, which is the value returned by FindFirstFlashCard or FindNextFlashCard. Used only when dwFlags equals PRJ_ENUM_FLASH.

dwFlags
[in] Specifies the valid flags. It is one of the values described in the following table, specifying the location to check.

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 Values

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

Remarks

This enhanced version of EnumProjects can enumerate both new object identifier (OID-based) and older operating-system-style file systems, including storage cards.

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

Requirements

Pocket PC: Windows Mobile 2000 and later
OS Versions: Windows CE 3.0 and later
Header: projects.h
Library: note_prj.lib