CFileFind::MatchesMask

Artykuł
06/10/2015

Wywołanie tej funkcji Członkowskich do testowania atrybutów znaleziony plik.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Parametry

dwMask
Określa atrybuty pliku, określone w WIN32_FIND_DATA strukturę, znaleziony plik.Aby wyszukać wiele atrybutów, użyj logiczną lub operator (|).Dopuszczalne jest dowolna kombinacja następujących atrybutów:
- Plik FILE_ATTRIBUTE_ENCRYPTED jest plik archiwum.Aplikacje oznaczania plików kopii zapasowej lub usuwanie za pomocą tego atrybutu.
- FILE_ATTRIBUTE_COMPRESSED plik lub katalog jest skompresowany.Dla pliku oznacza to, wszystkie dane w pliku jest skompresowany.Dla katalogu to oznacza, że kompresji jest domyślne dla nowo utworzonych plików i podkatalogów.
- FILE_ATTRIBUTE_DIRECTORY plik jest katalogiem.
- Plik nie ma ustawionych żadnych innych atrybutów.Ten atrybut jest prawidłowy tylko wtedy, gdy użyty samodzielnie.Inne atrybuty pliku zastąpić ten atrybut.
- FILE_ATTRIBUTE_HIDDEN plik jest ukryty.Jest nie mają zostać uwzględnione w katalogu zwykłych aukcji.
- Plik FILE_ATTRIBUTE_READONLY jest tylko do odczytu.Aplikacje można odczytać pliku, ale nie można w nim zapisywać lub usuń je.
- FILE_ATTRIBUTE_SYSTEM plik jest częścią lub jest używany wyłącznie przez system operacyjny.
- FILE_ATTRIBUTE_TEMPORARY plik jest używany do tymczasowego przechowywania.Aplikacje należy zapisać do pliku tylko wtedy, gdy jest to absolutnie konieczne.Większość danych plik pozostanie w pamięci bez opróżniane nośnika, ponieważ plik wkrótce zostanie usunięty.

Wartość zwracana

Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.Pobierz rozszerzone informacje o błędach, wywołanie funkcji Win32 GetLastError.

Uwagi

Musisz wywołać FindNextFile co najmniej raz przed wywoływaniem MatchesMask.

Przykład

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