CFileFind::MatchesMask

Articolo
06/10/2015

Chiamare la funzione membro per verificare gli attributi del file sul file trovato.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Parametri

dwMask
Specifica uno o più attributi del file, identificati nella struttura WIN32_FIND_DATA, per il file trovato. Per trovare più attributi, utilizzare il OR bit per bit (|operatore). Qualsiasi combinazione di attributi seguenti sono accettabili:
- FILE_ATTRIBUTE_ARCHIVE il file è un file di archivio. Le applicazioni utilizzano questo attributo per contrassegnare i file per l'esecuzione del backup o la rimozione.
- FILE_ATTRIBUTE_COMPRESSED il file o la directory è compresso. Per un file, ciò significa che tutti i dati nel file verranno compressi. Per una directory, significa che la compressione è l'impostazione predefinita per i file e le sottodirectory appena creato.
- FILE_ATTRIBUTE_DIRECTORY il file è una directory.
- FILE_ATTRIBUTE_NORMAL il file non sono stati impostati altri attributi. Questo attributo è valido solo se utilizzato singolarmente. Tutti gli altri attributi del file eseguono l'override di questo attributo.
- FILE_ATTRIBUTE_HIDDEN il file è nascosto. Non deve essere incluso in una directory ordinario.
- FILE_ATTRIBUTE_READONLY il file è di sola lettura. Le applicazioni possono leggere il file ma non possono scrivere o eliminarlo.
- FILE_ATTRIBUTE_SYSTEM il file faccia parte di oppure è utilizzato esclusivamente dal sistema operativo.
- FILE_ATTRIBUTE_TEMPORARY il file viene utilizzata per l'archiviazione temporanea. Le applicazioni devono scrivere nel file solo se è assolutamente necessario. La maggior parte dei dati del file rimane in memoria senza essere arrossitoe i contenuti multimediali in quanto il file precedentemente verrà eliminato.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0. Per ottenere informazioni dettagliate sugli errori, chiamare la funzione Win32 GetLastError.

Note

È necessario chiamare almeno una volta FindNextFile prima di chiamare MatchesMask.

Esempio

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