MFC OCX 控件變量 m_hWnd 為 NULL 排查：控件初始化失敗的常見原因

問題現象

MFC 對話框中插入自製 OCX 控件，關聯變量 m_myocx，運行時判斷 if (m_myocx.m_hWnd == NULL) 進入錯誤分支，控件無法使用。

m_hWnd 為 NULL 的含義

m_hWnd 是 CWnd 封裝的窗口句柄。為 NULL 表示：

• 控件未成功創建窗口（Create/CreateControl 失敗）。
• 控件尚未完成初始化（在 OnInitDialog 之前訪問）。
• 控件註冊失敗（CLSID 錯誤、未註冊、版本不匹配）。

排查步驟

1. 確認控件註冊：命令行執行 regsvr32 YourOcx.ocx，提示成功。
2. 檢查對話框資源：資源編輯器中控件屬性「可見」「禁用」設置正確，ID 與代碼一致。
3. 在 OCX 內部添加日誌：重寫 OnCreate、PreSubclassWindow，輸出調試信息確認調用順序。
4. 查看事件查看器：應用程序日誌中是否有 SideBySide、COM 錯誤。

常見解決方案

• 清理項目重新構建，強制重新生成類向導代碼。
• 確保 OCX 依賴的 DLL（MFC、CRT、自定義庫）在系統 PATH 或應用目錄下。
• 若使用 COleControlModule，檢查 InitInstance 返回 TRUE。

調試技巧

// OCX 代碼中
int CMyOcxCtrl::OnCreate(LPCREATESTRUCT lpCreateStruct) {
    TRACE(_T("OCX OnCreate called, hwnd=%p\n"), m_hWnd);
    if (COleControl::OnCreate(lpCreateStruct) == -1) return -1;
    TRACE(_T("OCX OnCreate success, hwnd=%p\n"), m_hWnd);
    return 0;
}

觀察輸出窗口確認窗口創建過程。