CFileFind::MatchesMask

Článek
06/10/2015

Volání funkce tento člen testování atributy souboru na nalezený soubor.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Parametry

dwMask
Určuje jednu nebo více atributy souborů uvedené v WIN32_FIND_DATA struktury souboru nalezen.Vyhledat více atributů, použijte bitový operátor OR operátor (|).Přijatelné je libovolná kombinace následujících atributů:
- FILE_ATTRIBUTE_ARCHIVE soubor je soubor archivu.Aplikace používají tento atribut k označení souborů pro zálohu nebo odstranění.
- FILE_ATTRIBUTE_COMPRESSED soubor nebo adresář je komprimován.Soubor to znamená všechna data v souboru je komprimován.Adresáře znamená, že komprese je výchozí pro nově vytvořené soubory a podadresáře.
- FILE_ATTRIBUTE_DIRECTORY soubor je adresář.
- FILE_ATTRIBUTE_NORMAL soubor nemá žádné atributy nastavit.Tento atribut je platný pouze v případě, že je použit samostatně.Všechny ostatní atributy souboru přepíše tento atribut.
- FILE_ATTRIBUTE_HIDDEN soubor je skrytý.Nejsou součástí běžných výpis.
- FILE_ATTRIBUTE_READONLY soubor je jen pro čtení.Aplikace mohou číst soubor, ale nelze do ní zapisovat nebo jej odstraňte.
- FILE_ATTRIBUTE_SYSTEM je součástí souboru nebo je používán výhradně operačního systému.
- FILE_ATTRIBUTE_TEMPORARY soubor je používán pro dočasné úložiště.Aplikace by do souboru zapisovat pouze, pokud je to nezbytně nutné.Většinu dat souboru zůstane v paměti bez právě vyprázdněna média, protože soubor bude brzy odstranit.

Vrácená hodnota

Nenulová hodnota, pokud je úspěšná. jinak 0.Chcete-li získat rozšířené informace o chybě, volání funkce Win32 GetLastError.

Poznámky

Musíte zavolat FindNextFile nejméně jednou před voláním MatchesMask .

Příklad

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