CFileFind::MatchesMask

项目
03/01/2013

调用该成员函数的测试在中找到的文件的属性。

virtual BOOL MatchesMask(
   DWORD dwMask 
) const;

参数

dwMask
在 WIN32_FIND_DATA 结构指定一个或多个文件属性，标识，为找到文件。若要搜索多个属性，请使用按位或(|)运算符。下面的属性组合可接受:
- FILE_ATTRIBUTE_ARCHIVE文件是一个存档文件。应用程序使用此特性将文件标记为备份或移除。
- FILE_ATTRIBUTE_COMPRESSED文件或目录压缩。对于文件，这意味着文件中的所有数据压缩。对于目录，这意味着压缩是新创建的文件和子目录的默认值。
- FILE_ATTRIBUTE_DIRECTORY文件的内容。
- FILE_ATTRIBUTE_NORMAL文件未设置其他特性。仅当单独使用时，此特性才有效。其他文件属性来重写此属性。
- FILE_ATTRIBUTE_HIDDEN文件是隐藏的。它不要包含在普通目录列表。
- FILE_ATTRIBUTE_READONLY文件只读。应用程序可以读取文件，但不能写入它或将其删除。
- 文件是一部分或操作系统以独占方式使用FILE_ATTRIBUTE_SYSTEM。
- FILE_ATTRIBUTE_TEMPORARY文件用于临时存储使用。应用程序将写入文件，仅当绝对必要。大多数文件中的数据在内存中保留，而无需刷新到媒体，因为文件很快将被删除。

返回值

非零，如果成功;否则为0。若要扩展的错误信息，调用Win32函数 GetLastError。

备注

您必须在调用之前 MatchesMask至少一个调用 FindNextFile。

示例

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