CodeFx：微軟開發技術全景式範例框架深度解析

專案簡介

CodeFx（代號 All-In-One Code Framework）是微軟 CodePlex 上的明星專案，彙整幾乎所有主流微軟開發技術的完整範例，並以多種語言實現同一功能。無論是初學者入門，還是資深開發者尋找現成模板，皆能大幅節省開發時間。

核心技術涵蓋範圍

框架結構清晰，主要模組包含：

• COM 元件與 ActiveX 控制項：ATL、MFC、VB、C# 四種技術並列實現
• 資料存取：ADO.NET、Entity Framework、LINQ to SQL 等
• 類別庫範例：通用工具類、擴充方法、設計模式實作
• 進程間通訊 (IPC)：Named Pipe、WCF、Remoting、Message Queue 等

深度學習筆記：ActiveX 控制項授權機制

框架中 ActiveX 範例完整示範了授權機制的實作細節，這是企業級控制項部署的關鍵：

1. 標頭檔修改：宣告授權介面

BEGIN_OLEFACTORY(CMFCActiveXCtrl)
    virtual BOOL VerifyUserLicense();
    virtual BOOL GetLicenseKey(DWORD, BSTR FAR*);
END_OLEFACTORY(CMFCActiveXCtrl)

2. 實作檔修改：定義授權字串與檢查邏輯

static const TCHAR BASED_CODE _szLicFileName[] = _T("License.lic");
static const WCHAR BASED_CODE _szLicString[] = L"Copyright (c) 2000 ";

BOOL CMFCActiveXCtrl::CMFCActiveXCtrlFactory::VerifyUserLicense() {
    return AfxVerifyLicFile(AfxGetInstanceHandle(), _szLicFileName, _szLicString);
}

BOOL CMFCActiveXCtrl::CMFCActiveXCtrlFactory::GetLicenseKey(DWORD dwReserved, BSTR FAR* pbstrKey) {
    if (pbstrKey == NULL) return FALSE;
    *pbstrKey = SysAllocString(_szLicString);
    return (*pbstrKey != NULL);
}

關鍵提醒：修改 _szLicString 時，必須同步更新 .LIC 檔案第一行，否則授權驗證失效。

3. IDL 檔案：標記授權屬性

[ uuid(E389AD6C-4FB6-47AF-B03A-A5A5C6B2B820), licensed,
  helpstring("MFCActiveX Control"), control ]
coclass MFCActiveX

實用工具函數：AutoWrap 簡化 COM 呼叫

框架封裝了 AutoWrap 函數，以變參方式統一處理 IDispatch::Invoke 細節，支援屬性讀寫、方法呼叫，極大降低 COM 程式碼複雜度：

HRESULT AutoWrap(int autoType, VARIANT* pvResult, IDispatch* pDisp,
                 LPOLESTR ptName, int cArgs) {
    // ... 參數封裝、GetIDsOfNames、Invoke 呼叫、錯誤處理 ...
}

DLL 延遲載入技巧

使用 <Delayimp.h> 實現 DLL 延遲載入，避免啟動時不必要的依賴載入開銷：

// 卸載延遲載入的 DLL
PCSTR pszDll = "CppDllExport.dll";
_tprintf(_T("__FUnloadDelayLoadedDLL2 => %d\n"),
         __FUnloadDelayLoadedDLL2(pszDll));

結語

CodeFx 不僅是範例庫，更是微軟技術棧的「百科全書」。建議開發者：

1. 依專案需求挑選對應模組深入研讀
2. 將常用片段整理為個人程式碼片段庫
3. 關注專案更新，掌握最新技術實作模式