CFileFind::MatchesMask

Makale
02/26/2013

Dosya öznitelikleri üzerinde bulunan dosyayı sınamak için bu üye işlevini çağırın.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Parametreler

dwMask
Tanımlanan bir veya daha fazla dosya özniteliklerini belirtir WIN32_FIND_DATA bulunan dosya yapısı.Bitsel or birden çok öznitelik için arama yapmak için kullanın (|) işleci.Aşağıdaki öznitelikler herhangi bir bileşimini kabul edilebilir:
- FILE_ATTRIBUTE_ARCHIVE dosyası bir arşiv dosyasıdır.Uygulamaları dosyaları yedekleme ve kaldırma için işaretlemek için bu özniteliği kullanın.
- Sıkıştırılmış dosya veya dizin FILE_ATTRIBUTE_COMPRESSED.Bir dosya için bu sıkıştırılmış dosyadaki verilerin tümü anlamına gelir.Bir dizin için bu yeni oluşturulan dosyaları ve alt dizinleri için varsayılan sıkıştırma olduğunu anlamına gelir.
- FILE_ATTRIBUTE_DIRECTORY dosyası bir dizindir.
- FILE_ATTRIBUTE_NORMAL dosya kümesi niteliklerine sahip.Bu özniteliği, yalnızca tek başına kullanılması durumunda geçerlidir.Diğer dosya özniteliklerini bu özniteliği geçersiz kılar.
- Dosya gizli FILE_ATTRIBUTE_HIDDEN.Bir sıradan dizin listeleme dahil edilmemesi değil.
- FILE_ATTRIBUTE_READONLY dosyası salt okunur.Uygulamalar dosya okunamıyor ancak olamaz yazma veya silin.
- Dosya parçası olan veya yalnızca işletim sistemi tarafından kullanılan FILE_ATTRIBUTE_SYSTEM.
- FILE_ATTRIBUTE_TEMPORARY dosyası geçici depolama için kullanılır.Uygulamalar yalnızca kesinlikle gerekli olan durumlarda dosyasına yazmanız gerekir.Dosyanın verilerinin çoğunu dosya yakında silinmiş olduğundan ortam Temizlenen olmadan bellekte kalır.

Dönüş Değeri

Başarılı olursa sıfırdan farklı; Aksi halde 0.Genişletilmiş hata bilgilerini için Win32 işlev çağrısı GetLastError.

Notlar

Çağırması gerekir FindNextFile arama önce en az bir kez MatchesMask.

Örnek

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