int DirBegin(char *value);

 

Begins a directory search for files.

 

Return Value

 

Returns one if the path specified was opened successfully.

 

Parameters

 

value

The path to search for files.  Currently, only "Documents" is supported.

 

Remarks

 

DirBegin() will initialize a file search for the path specified. ALWAYS call DirEnd() after calling DirBegin()!

 

Availability

 

Available in DragonFireSDK 1.4 and later.

 

Example

 

The example below enumerates the files in the Documents directory and prints them to the console.

 

#include "DragonFireSDK.h"

 

char FileName[100];

 

void AppMain()

{

   DirBegin("Documents");

  while (DirNext(FileName, 100))

       printf("Found file: %s\n", FileName);

   DirEnd();

}

 

void AppExit()

{

 

}

 

void OnTimer()

{

 

}