Windows API OPENFILENAME lpstrFilter文件扩展名过滤失效问题

核心错误原因 #

你遇到的过滤完全不生效、切换文件类型不刷新的问题，根因是Flags配置错误，和lpstrFilter字符串格式无关：

• 你在opn.Flags里加了OFN_ENABLEHOOK标记，这个标记的作用是告知系统你要挂载自定义对话框钩子函数接管部分对话框逻辑，但你同时把opn.lpfnHook设为了NULL。这种参数矛盾会直接破坏对话框内置的文件枚举、类型过滤逻辑，导致所有过滤规则失效，默认展示全部文件。
• 你写的lpstrFilter字符串格式是完全正确的，符合「显示名\0匹配规则\0」、末尾双null终止的要求，这部分没有问题。
• 其余参数里lpstrDefExt的多余括号不影响功能，不属于错误。

修复方法 #

根据你是否需要自定义钩子选择对应修改即可：

1. 如果你不需要自定义对话框钩子（从当前代码看你没有写钩子逻辑，属于误加标记）：直接把OFN_ENABLEHOOK从Flags中移除即可，修正后的Flags配置为：

   opn.Flags = OFN_EXPLORER;
   

   注：新版Windows系统中OFN_EXPLORER是默认开启的，即使不写也会展示资源管理器风格的文件选择框，加上是为了兼容老版本系统。
2. 如果你后续需要添加自定义钩子逻辑：不要传NULL给lpfnHook，必须传入符合OFNHOOKPROC函数签名的合法回调函数地址。

修正后可正常运行的核心代码片段 #

void openfile() {        
    ZeroMemory(&opn, sizeof(opn));
    opn.lStructSize = sizeof(opn);
    opn.hwndOwner = hWindow;
    opn.lpstrFile = tz1;
    opn.lpstrFile[0] = '\0';
    opn.nMaxFile = sizeof(tz1);
    opn.lpstrFilter = "JPG - JPEG File\0*.JPG\0PNG File\0*.PNG\0BMP - Bitmat File\0*.BMP\0";
    opn.nFilterIndex = 2; // 默认选中PNG过滤项
    opn.lpstrFileTitle = NULL;
    opn.lpstrTitle = "Select an Image";
    opn.nMaxFileTitle = 0;
    opn.lpstrInitialDir = NULL; 
    opn.hInstance = hInstance;
    opn.lpstrDefExt = "JPG";
    // 移除了无效的OFN_ENABLEHOOK标记
    opn.Flags = OFN_EXPLORER;
    bfile = 0;
    if (GetOpenFileName(&opn)) {
        if (access(tz1, F_OK) == -1){
            // 此处放文件不存在的提示逻辑
        }
    }
}

修改后对话框启动时会默认按照你设置的nFilterIndex=2加载PNG过滤规则，仅展示.png后缀文件；切换下拉框中的JPG、BMP选项时，对话框会自动刷新展示对应后缀的文件。

内容的提问来源于stack exchange，提问作者nabi