CFileFind::MatchesMask

Article
06/10/2015

Appelez la fonction membre pour tester les attributs de fichier du fichier rencontrée.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Paramètres

dwMask
Spécifie un ou plusieurs attributs de fichier, identifiés dans la structure de WIN32_FIND_DATA , pour le fichier rencontrée. Pour rechercher plusieurs attributs, utilisez bits OR (|opérateur). Toute combinaison d'attributs suivants est acceptable :
- FILE_ATTRIBUTE_ARCHIVE le fichier est un fichier d'archivage. Les applications utilisent cet attribut pour marquer les fichiers pour la sauvegarde ou la suppression.
- FILE_ATTRIBUTE_COMPRESSED le fichier ou le dossier est compressé. Pour un fichier, cela signifie que toutes les données du fichier sont compressées. Pour un dossier, cela signifie que la compression est la valeur par défaut pour les fichiers et sous-répertoires nouvellement créée.
- FILE_ATTRIBUTE_DIRECTORY le fichier est un répertoire.
- FILE_ATTRIBUTE_NORMAL le fichier n'a aucun attribut défini. Cet attribut est valide uniquement s'il est utilisé seul. Tous les autres attributs de fichier remplacer cet attribut.
- FILE_ATTRIBUTE_HIDDEN le fichier est masqué. Il ne doit pas être inclus dans une liste de répertoires ordinaires.
- FILE_ATTRIBUTE_READONLY le fichier est en lecture seule. Les applications peuvent lire le fichier mais ne peut pas y écrire ou le supprimer.
- FILE_ATTRIBUTE_SYSTEM le fichier fait partie de ou est utilisé exclusivement par le système d'exploitation.
- FILE_ATTRIBUTE_TEMPORARY le fichier est utilisé pour le stockage temporaire. Les applications doivent écrire dans le fichier uniquement si absolument nécessaire. La plupart des données du fichier reste dans la mémoire sans être vidé le média parce que le fichier sera bientôt supprimé.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0. Pour obtenir des informations d'erreurs étendues, appelez la fonction GetLastErrorWin32.

Notes

Vous devez appeler FindNextFile au moins une fois avant d'appeler MatchesMask.

Exemple

// This code fragment shows all of the files in the root directory 
// of drive C: which have either the hidden attribute or the system 
// attribute, or both.

CFileFind finder;

BOOL bWorking = finder.FindFile(_T("C:\\*.*"));

while (bWorking)
{
   bWorking = finder.FindNextFile();

   if (finder.MatchesMask(FILE_ATTRIBUTE_HIDDEN | 
      FILE_ATTRIBUTE_SYSTEM))
   {
      _tprintf_s(_T("%s\n"), (LPCTSTR) finder.GetFileName());
   }
}