CFileFind::MatchesMask

Artigo
08/25/2010

telefonar 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 no WIN32_FIND_DATA estrutura, para o arquivo foi encontrado.Para pesquisar vários atributos, use o operador bit a bit ou operador (|).Qualquer combinação dos seguintes atributos é aceitável:
- FILE_ATTRIBUTE_ARCHIVE o arquivar está um arquivar.Aplicativos usam esse atributo para marcar os arquivos de backup ou de remoção.
- FILE_ATTRIBUTE_COMPRESSED o arquivo ou diretório está compactado.Para um arquivo, isso significa que todos os dados no arquivo é compactado.Para um diretório, isso significa que a compactação é padrão para novos arquivos e subdiretórios.
- FILE_ATTRIBUTE_DIRECTORY o arquivo é um diretório.
- FILE_ATTRIBUTE_NORMAL o arquivo não tiver outros atributos conjunto.Esse atributo é válido somente se usado sozinho.Todos os outros atributos de arquivo substituem esse atributo.
- FILE_ATTRIBUTE_HIDDEN o arquivo está oculto.Ele não é ser incluídos em uma listagem de diretório comum.
- FILE_ATTRIBUTE_READONLY o arquivo é somente leitura.Aplicativos podem ler o arquivo mas não é possível gravar nele ou excluí-lo.
- FILE_ATTRIBUTE_SYSTEM o arquivo é parte de ou é usado exclusivamente pelo sistema operacional.
- FILE_ATTRIBUTE_TEMPORARY o arquivo está sendo usado para armazenamento temporário.Aplicativos devem gravar o arquivo apenas se absolutamente necessário.A maioria dos dados do arquivo permanece na memória sem sendo liberadas para a mídia como o arquivo de logo será ser excluído.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.Para obter mais informações sobre o erro, telefonar Win32 funcionam GetLastError.

Comentários

Você deve telefonar FindNextFile pelo menos uma vez antes de telefonar ndo 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());
   }
}