翻译《The Old New Thing》 - What does SHGFI_USEFILEATTRIBUTES mean?

What does SHGFI_USEFILEATTRIBUTES mean? - The Old New Thing (microsoft.com)https://devblogs.microsoft.com/oldnewthing/20040601-00/?p=39073

Raymond Chen 2004年06月01日

        在使用 SHGetFileInfo 函数时，你可以设置一个名为 SHGFI_USEFILEATTRIBUTES 的标志。这个标志的作用是什么呢？

        简而言之，这个标志告诉函数：

“请不要直接访问磁盘。请假设我指定的文件或目录存在，并且它的文件属性正如我通过 dwFileAttributes 参数传递的那样。即使实际上这个文件或目录并不存在，也请这样做。”

        这个标志可以用于获取特定文件类型的图标。例如，如果你想获取文本文件的图标，你可以传递一个名为“x.txt”的文件名，设置 uFlags 为 SHGFI_USEFILEATTRIBUTES，并把文件属性设置为 FILE_ATTRIBUTE_NORMAL。

        为什么选择“x.txt”作为文件名呢？因为你希望它具有“.txt”扩展名，并且确保它是一个合法的文件名。（避免使用如“???.txt”这样的非法文件名。）

        为什么选择 FILE_ATTRIBUTE_NORMAL 作为文件属性？因为你希望 SHGetFileInfo 函数将该文件视为一个普通的文件。（如果你选择 FILE_ATTRIBUTE_DIRECTORY，那么函数将返回一个文件夹图标，因为你指示函数将“x.txt”视为一个目录。）

        需要指出的是，由于你指示函数进行“假设”，你将失去一些真实文件存在时才能获得的信息。

        例如，如果某个文件类型的图标会根据文件内容变化，那么当你使用 SHGFI_USEFILEATTRIBUTES 标志时，函数将不会返回这种动态图标，因为在函数的“假设”中，这个文件是没有实际内容的。