CFileFind::MatchesMask

Artículo
06/10/2015

Llame a esta función miembro para probar los atributos de archivo en el archivo encontrado.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Parámetros

dwMask
Especifica uno o más atributos de archivo, identificados en la estructura de WIN32_FIND_DATA , para el archivo encontrado. Para buscar varios atributos, utilice el bit a bit OR (|) operador. Cualquier combinación de los siguientes atributos es aceptable:
- El archivo de FILE_ATTRIBUTE_ARCHIVE The es un archivo de almacenamiento. Las aplicaciones utilizan este atributo para marcar los archivos para incluirlos en copias de seguridad o eliminación.
- Se comprime el archivo o directorio de FILE_ATTRIBUTE_COMPRESSED The. Para un archivo, esto significa que todos los datos del archivo está comprimido. Para un directorio, esto significa que la compresión es el valor predeterminado para los archivos y subdirectorios creados recientemente.
- El archivo de FILE_ATTRIBUTE_DIRECTORY The es un directorio.
- El archivo de FILE_ATTRIBUTE_NORMAL no establecido ningún otro atributo. Este atributo sólo es válido si se utiliza por sí solo. Todos los demás atributos de archivo reemplazan este atributo.
- El archivo está oculto de FILE_ATTRIBUTE_HIDDEN The. No debe incluir en una lista de directorios normal.
- El archivo de FILE_ATTRIBUTE_READONLY The es de sólo lectura. Las aplicaciones pueden leer el archivo pero no pueden escribir o eliminarlo.
- El archivo de FILE_ATTRIBUTE_SYSTEM Z es parte de o lo utiliza exclusivamente el sistema operativo.
- El archivo de FILE_ATTRIBUTE_TEMPORARY The se utiliza para el almacenamiento temporal. Las aplicaciones deben escribir en el archivo si es absolutamente necesario. La mayoría de los datos del archivo permanecen en memoria sin ser vaciado en medios porque el archivo pronto se eliminará.

Valor devuelto

Distinto de cero si correctamente; si no 0. Para obtener información de error extendida, llame a la función GetLastErrorde Win32.

Comentarios

Debe llamar a FindNextFile por lo menos una vez antes de llamar a MatchesMask.

Ejemplo

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