CFileFind::MatchesMask

Artikel
06/10/2015

Rufen Sie die Memberfunktion auf, um die Dateiattribute auf der gesuchten Datei zu testen.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Parameter

dwMask
Gibt eine oder mehrere Dateiattribute an, in der WIN32_FIND_DATA-Struktur identifiziert, für die gesuchte Datei. Um für mehrere Attribute zu suchen, verwenden Sie den bitweisen OR (|Operator). Jede beliebige Kombination der folgenden Attribute ist zulässig:
- FILE_ATTRIBUTE_ARCHIVE die Datei ist eine Archivdatei. Anwendungen verwenden dieses Attribut, um Dateien für die Sicherung oder das Entfernen zu markieren.
- FILE_ATTRIBUTE_COMPRESSED die Datei oder das Verzeichnis ist komprimiert. Eine Datei bedeutet dies, dass alle Daten in der Datei komprimiert werden. Für ein Verzeichnis bedeutet dies, dass Komprimierung der Standard für neu erstellte Dateien und Unterverzeichnisse ist.
- FILE_ATTRIBUTE_DIRECTORY die Datei ist ein Verzeichnis.
- FILE_ATTRIBUTE_NORMAL die Datei verfügt über keine anderen festgelegten Attribute. Dieses Attribut ist nur gültig, wenn es allein verwendet wird. Alle anderen Dateiattribute überschreiben dieses Attribut.
- FILE_ATTRIBUTE_HIDDEN die Datei ist ausgeblendet. Sie wird nicht in einer gewöhnlichen Verzeichnisliste enthalten sind.
- FILE_ATTRIBUTE_READONLY die Datei ist schreibgeschützt. Anwendungen können die Datei lesen, jedoch können darauf nicht schreiben oder sie löschen.
- FILE_ATTRIBUTE_SYSTEM die Datei ist Teil von oder wird ausschließlich durch das Betriebssystem verwendet.
- FILE_ATTRIBUTE_TEMPORARY die Datei wird für temporäre Speicherung verwendet. Anwendungen sollten in die Datei schreiben, wenn es unbedingt erforderlich ist. Die meisten Daten der Datei verbleibt im Arbeitsspeicher, ohne auf die Medien geschrieben werden, da die Datei wieder gelöscht wird.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls. Um erweiterte Fehlerinformationen abzurufen, rufen Sie die Win32-Funktion GetLastError auf.

Hinweise

Sie müssen FindNextFile mindestens einmal aufrufen, bevor Sie MatchesMask aufrufen.

Beispiel

// 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());
   }
}