CFileFind::MatchesMask

Статья
02/20/2013

Эта функция-член вызывается с целью проверки атрибуты файла на нахоженном файле.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Параметры

dwMask
Указывает один или более указанные атрибуты файла в структуре WIN32_FIND_DATA, для найденного файла.Для поиска нескольких атрибутов, используйте побитовое ИЛИ (|оператор).Допустимо любое сочетание следующих атрибутов:
- FILE_ATTRIBUTE_ARCHIVE файл архивный файл.Приложения используют этот атрибут, чтобы пометить файлы для резервного копирования или удаления.
- FILE_ATTRIBUTE_COMPRESSED файл или каталог сжато.Для файла, это означает, что сжаты все данные в файле.Для каталога, это означает, что сжатие значение по умолчанию для вновь созданных файлов и подкаталогов.
- FILE_ATTRIBUTE_DIRECTORY файл каталог.
- FILE_ATTRIBUTE_NORMAL файл не имеет других заданы атрибуты.Этот атрибут действителен, только если используется отдельно.Все другие атрибуты файла переопределяют этот атрибут.
- FILE_ATTRIBUTE_HIDDEN файл скрыто.Он не должны включаться в обычном списке каталога.
- FILE_ATTRIBUTE_READONLY файл доступен только для чтения.Приложения могут считывать файл, но не могут записывать в него или удалять его.
- FILE_ATTRIBUTE_SYSTEM файл или используется исключительно операционной системой.
- FILE_ATTRIBUTE_TEMPORARY файл используется для временного хранения.Приложения должны выполнить запись в файл, только если совершенно обязательный.Большая часть сведений о файлах остается в памяти без потопленным на носитель, поскольку файл вскоре будет удалена.

Возвращаемое значение

Ненулевой, если успешно; в противном случае – значение 0.Чтобы получить расширенные сведения об ошибке, вызовите функцию Win32 GetLastError.

Заметки

Необходимо вызвать FindNextFile хотя бы один раз перед вызовом MatchesMask.

Пример

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