Share via


How to: List and Locate Storage Card Files

4/8/2010

The examples in this topic demonstrate how to list and locate storage card files.

The SHGetDocumentsFolder function works with storage cards that do not have a My Documents folder, as well as with older storage cards that do. Use SHGetDocumentsFolder to access all documents on the device, whether they are in main memory or on a storage card.

#include <shlobj.h>
TCHAR szPath[MAX_PATH];
if (! SHGetDocumentsFolder(_T("\\"), szPath))
{
   MessageBox(NULL, _T("Invalid Path"), _T("Call Failed"), MB_OK);
}
else
{
   MessageBox(NULL, szPath, _T("My Docs Path"), MB_OK);
}

You can also use the EnumProjectsEx and the EnumProjectsFilesEx functions to list all folders and files on your storage cards, and then use the FindFirstProjectFile and the FindNextProjectFile functions to locate particular files, as shown in the following example.

Example

#include <shlobj.h>
int iNumFolders;
TCHAR szName[1000];
TCHAR cFileName[1000];
int iNumOfFlashCard = 1;
for (int index = 0; index < iNumOfFlashCard; ++index)
{
   // Store the directory name in szName.
   wsprintf(szName, lpwfdFlashCard[index].cFileName);
   iNumFolders = EnumProjects (EnumProjProc, lpwfdFlashCard[index].dwOID, PRJ_ENUM_FLASH, 0);
}
   // Note: In the preceding code, EnumProjProc is a user-defined callback function that is used to perform operations within each directory that EnumProjects encounters. The following code shows how to use EnumProjProc to find directories and files on storage cards.
BOOL CALLBACK EnumProjProc (DWORD dwOID, LPARAM lParam);
{
   // Search handle for files under each directory.
   HANDLE hSearch;
   // Structure for storing the storage card information retrieved by CeOidGetInfo.
   CEOIDINFO OidInfo;
   // Structure for storing file information.
   WIN32_FIND_DATA fd;
   // String for storing the file or directory name on every storage card.
   TCHAR szName[1000];
   // String for storing the error message.
   TCHAR szErrorMsg[1000];
   // Wildcard file names with full paths for searching these types of files.
   TCHAR szFilePath[MAX_PATH];
   // Whether the search for files is finished.
   BOOLEAN bFinished = FALSE; 
   // Get storage card information by using its object identifier.
   CeOidGetInfo(dwOID, &OidInfo);
   // Store the directory name in szName.
   wsprintf(szName, OidInfo.infDirectory.szDirName);
   // Construct the wildcard file name with the full path for searching that type of file.
   wcscpy(szFilePath, OidInfo.infDirectory.szDirName);
   wcscat(szFilePath, TEXT("\\*.*"));
   // Search for the first project file under the current directory.
   hSearch = FindFirstProjectFile( szFilePath, &fd);
   if (hSearch == INVALID_HANDLE_VALUE)
   {
      wsprintf(szErrorMsg, TEXT("No files found."));
      bFinished = TRUE;
   }
   // Find all of the files and retrieve the file names.
   while (!bFinished)
   {
      // Store the file name in szName.
      wsprintf(szName, fd.cFileName);
      if (!FindNextProjectFile(hSearch, &fd))
      {
         // Finished.
         bFinished = TRUE;
         if (GetLastError() == ERROR_NO_MORE_FILES)
         {
            wsprintf(szErrorMsg, TEXT("Found all of the files."));
         }
      }
   }
   // Close the search handle.
   FindClose(hSearch);
   return TRUE;
}

See Also

Tasks

How to: Enumerate Storage Cards

Concepts

Automatically Run an Application from a Storage Card
File and Application Management Reference