EnumProjectsEx

  • Article

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

Header projects.h
Library note_prj.lib
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

File and Application Management Functions
EnumProjectsExCallback
EnumProjectsFilesEx
FindFirstFlashCard
FindNextFlashCard