EnumProjects

Article
08/28/2006

The EnumProjects function enumerates folders in main memory or on a mountable file system, such as a flash card.

Note This function is deprecated. Use EnumProjectsEx instead.

Syntax

int EnumProjects(
  PROJECT_ENUMPROC lpEnumProc, 
  DWORD dwOidFlash, 
  DWORD dwFlags, 
  LPARAM lParam 
);

Parameters

lpEnumProc
[in] Long pointer to a callback function of the following prototype:

BOOL CALLBACK EnumProjectsCallback(DWORD dwOid**, LPARAM** lParam**);**

If this pointer is set to NULL, EnumProjects returns only the number of projects.
dwOidFlash
[in] Specifies an object identifier of the specified mountable file system. The dwOidFlash parameter is used only for dwFlags equals PRJ_ENUM_FLASH.

dwFlags
[in] Specifies the valid flags. It is one of the values described in the following table.

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

lParam
[in] Caller-defined parameter passed to lpEnumProc. Use this parameter to pass information to the callback function.

Return Values

The number of folders enumerated indicates success. If there are no folders to enumerate, EnumProjects returns zero. If lpEnumProc is NULL, EnumProjects still returns the number of projects.

Remarks

This function is provided for backward compatibility. On some older file systems, EnumProjects is unable to count or enumerate some folders, such as storage cards. Instead, use EnumProjectsEx, which corrects those deficiencies.

Use the callback function to perform any operations within the enumerated folders — for example, to pass out the name of each folder and then display all these names in a dialog box. The callback function returns FALSE to discontinue the enumeration.

Requirements

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