VS2008项目迁移至VS2019后调用GetDlgItem返回无效句柄问题

排查方向 #

• 资源ID冲突校验：VS不同版本自动生成资源ID的逻辑存在差异，迁移过程中resource.h可能生成重复的IDC_PPO_TYPE1宏定义，或者宏值被其他头文件覆盖。需确认IDC_PPO_TYPE1的宏值在全项目唯一，且与资源文件中定义的ID值匹配。
• 调用时机校验：VS2019的窗口初始化时序和VS2008不同，可能调用GetDlgItem时父窗体Hndl对应的控件还未完成创建。需确认调用位置在WM_INITDIALOG消息触发之后，且调用时IsWindow(Hndl)返回值为真。
• 字符集配置校验：VS2019默认项目字符集为Unicode，VS2008老项目多默认使用多字节字符集，字符集不匹配可能导致资源加载异常，控件未被正常创建。
• 资源编译产物校验：迁移后残留的VS2008编译中间文件（.aps、.res后缀）可能和VS2019编译的资源冲突，导致资源加载错配。
• 高DPI适配校验：VS2019默认开启的高DPI感知逻辑可能导致老项目的控件布局计算异常，部分控件被错误隐藏或创建失败。

解决方案 #

• 资源ID冲突修复：打开resource.h文件手动排查IDC_PPO_TYPE1的宏定义，删除重复定义，可在GetDlgItem调用前添加日志输出IDC_PPO_TYPE1的实际值，确认和预期一致。
  示例校验代码：

  LOG_INFO() << "IDC_PPO_TYPE1 value is " << IDC_PPO_TYPE1;
  PPOtypeComboHndl[0] = GetDlgItem(Hndl, IDC_PPO_TYPE1);
  

• 调用时机调整：将GetDlgItem的调用逻辑移动到窗体的OnInitDialog/WM_INITDIALOG处理函数中执行，避免提前调用。
• 字符集适配：进入项目属性→高级→字符集，修改为和VS2008项目一致的「使用多字节字符集」；如果需要保留Unicode字符集，需补全所有窗口创建、资源加载相关代码的宽字符适配逻辑。
• 资源编译修复：清理解决方案后手动删除所有编译中间文件，右键点击项目的.rc资源文件选择「编译」，确认资源编译无警告后再全量编译整个项目。
• 高DPI适配调整：进入项目属性→链接器→清单文件→DPI感知，选择「否」测试问题是否复现，若确认是高DPI适配导致，需手动调整控件布局逻辑适配高DPI场景。

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