CFileFind::MatchesMask

Artigo
02/25/2013

Chamar essa função de membro para testar os atributos de arquivo no arquivo encontrado.

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

Parâmetros

dwMask
Especifica um ou mais atributos de arquivo, identificados na estrutura de WIN32_FIND_DATA , para o arquivo encontrado.Para procurar por vários atributos, use o OPERADOR bit a bit (|operador).Qualquer combinação dos seguintes atributos é aceitável:
- FILE_ATTRIBUTE_ARCHIVE o arquivo é um arquivo neutro.Aplicativos usam esse atributo para marcar os arquivos de backup ou de remoção.
- FILE_ATTRIBUTE_COMPRESSED o arquivo ou diretório for compactado.Para um arquivo, isso significa que todos os dados no arquivo são compactados.Para um diretório, isso significa que a compactação é o padrão para arquivos e subpastas recém-criado.
- FILE_ATTRIBUTE_DIRECTORY o arquivo é um diretório.
- FILE_ATTRIBUTE_NORMAL o arquivo não tem outros atributos definidos.Esse atributo é válido somente se usado sozinho.Todos outros atributos de arquivo substituem este atributo.
- FILE_ATTRIBUTE_HIDDEN o arquivo está oculto.Não deve ser incluído em uma listagem de diretório.
- FILE_ATTRIBUTE_READONLY o arquivo é somente leitura.Os aplicativos podem ler o arquivo mas não podem gravar ou excluí-lo.
- FILE_ATTRIBUTE_SYSTEM o arquivo é parte ou é usado exclusivamente pelo sistema operacional.
- FILE_ATTRIBUTE_TEMPORARY o arquivo está sendo usado para armazenamento temporário.Os aplicativos devem gravar o arquivo somente se absolutamente necessário.A maioria dos dados do arquivo permanece na memória sem ser liberado mídia porque o arquivo será excluído brevemente.

Valor de retorno

Diferente de zero se com êxito; se não 0.Para obter informações de erro estendido, chame a função GetLastErrorWin32.

Comentários

Você deve chamar FindNextFile pelo menos uma vez antes de chamar MatchesMask.

Exemplo

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