C++ Programmer's Cookbook

COM編程入門

第一部分 什么是COM，如何使用COM

文/趙湘寧

COM——到底是什么？——COM標(biāo)準(zhǔn)的要點(diǎn)介紹，它被設(shè)計(jì)用來解決什么問題？
基本元素的定義——COM術(shù)語以及這些術(shù)語的含義。
使用和處理COM對(duì)象——如何創(chuàng)建、使用和銷毀COM對(duì)象。
基本接口——描述IUnknown基本接口及其方法。
掌握串的處理——在COM代碼中如何處理串。
應(yīng)用COM技術(shù)——例子代碼，舉例說明本文所討論的所有概念。
處理HRESULT——HRESULT類型描述，如何監(jiān)測(cè)錯(cuò)誤及成功代碼。

HRESULT CoCreateInstance (
    REFCLSID  rclsid,
    LPUNKNOWN pUnkOuter,
    DWORD     dwClsContext,
    REFIID    riid,
    LPVOID*   ppv );

HRESULT     hr;
IShellLink* pISL;

    hr = CoCreateInstance ( CLSID_ShellLink,         // coclass 的CLSID 
                            NULL,                    // 不是用聚合
                            CLSCTX_INPROC_SERVER,    // 服務(wù)器類型
                            IID_IShellLink,          // 接口的IID 
                            (void**) &pISL );        // 指向接口的指針

    if ( SUCCEEDED ( hr ) )
        {
        // 用pISL調(diào)用方法
        }
    else
        {
        // 不能創(chuàng)建COM對(duì)象，hr 為出錯(cuò)代碼
        }

// 像上面一樣創(chuàng)建COM 對(duì)象， 然后，

    if ( SUCCEEDED ( hr ) )
        {
        // 用pISL調(diào)用方法

        // 通知COM 對(duì)象不再使用它
        pISL->Release();
        }

HRESULT IUnknown::QueryInterface (
    REFIID iid,
    void** ppv );

int WideCharToMultiByte (
    UINT    CodePage,
    DWORD   dwFlags,
    LPCWSTR lpWideCharStr,
    int     cchWideChar,
    LPSTR   lpMultiByteStr,
    int     cbMultiByte,
    LPCSTR  lpDefaultChar,
    LPBOOL  lpUsedDefaultChar );

// 假設(shè)已經(jīng)有了一個(gè)Unicode 串 wszSomeString...
char szANSIString [MAX_PATH];

    WideCharToMultiByte ( CP_ACP,                // ANSI 代碼頁
                          WC_COMPOSITECHECK, // 檢查重音字符
                          wszSomeString,         // 原Unicode 串
                          -1,                    // -1 意思是串以0x00結(jié)尾
                          szANSIString,          // 目的char字符串
                          sizeof(szANSIString),  // 緩沖大小
                          NULL,                  // 肥缺省字符串
                          NULL );                // 忽略這個(gè)參數(shù)
調(diào)用這個(gè)函數(shù)后，szANSIString將包含Unicode串的ANSI版本。

size_t wcstombs (
    char*          mbstr,
    const wchar_t* wcstr,
    size_t         count );

以下是編程步驟：

初始化COM庫。 （Initialize）
創(chuàng)建一個(gè)與活動(dòng)桌面交互的COM對(duì)象，并取得IActiveDesktop接口。
調(diào)用COM對(duì)象的GetWallpaper()方法。
如果GetWallpaper()成功，則輸出/顯示墻紙文件名。
釋放接口（Release()）。
收回COM庫（Uninitialize）。

WCHAR   wszWallpaper [MAX_PATH];
CString strPath;
HRESULT hr;
IActiveDesktop* pIAD;

    // 1. 初始化COM庫（讓W(xué)indows加載DLLs）。通常是在程序的InitInstance()中調(diào)用
    // CoInitialize ( NULL )或其它啟動(dòng)代碼。MFC程序使用AfxOleInit()。

    CoInitialize ( NULL );

    // 2. 使用外殼提供的活動(dòng)桌面組件對(duì)象類創(chuàng)建COM對(duì)象。
    // 第四個(gè)參數(shù)通知COM需要什么接口(這里是IActiveDesktop).

    hr = CoCreateInstance ( CLSID_ActiveDesktop,
                            NULL,
                            CLSCTX_INPROC_SERVER,
                            IID_IActiveDesktop,
                            (void**) &pIAD );

    if ( SUCCEEDED(hr) )
        {
        // 3. 如果COM對(duì)象被創(chuàng)建成功，則調(diào)用這個(gè)對(duì)象的GetWallpaper() 方法。
        hr = pIAD->GetWallpaper ( wszWallpaper, MAX_PATH, 0 );

        if ( SUCCEEDED(hr) )
            {
            // 4. 如果 GetWallpaper() 成功，則輸出它返回的文件名字。
            // 注意這里使用wcout 來顯示Unicode 串wszWallpaper.  wcout 是
            // Unicode 專用，功能與cout.相同。
            wcout << L"Wallpaper path is:\n    " << wszWallpaper << endl << endl;
            }
        else
            {
            cout << _T("GetWallpaper() failed.") << endl << endl;
            }

        // 5. 釋放接口。
        pIAD->Release();
        }
    else
        {
        cout << _T("CoCreateInstance() failed.") << endl << endl;
        }

    // 6. 收回COM庫。MFC 程序不用這一步，它自動(dòng)完成。
CoUninitialize();

以下是編程步驟：

初始化COM 庫。 
創(chuàng)建一個(gè)用于建立快捷方式的COM 對(duì)象并取得IShellLink 接口。
調(diào)用IShellLink 接口的SetPath()方法
調(diào)用對(duì)象的QueryInterface()函數(shù)并取得IPersistFile接口。
調(diào)用IPersistFile 接口的Save()方法。
釋放接口
收回COM庫

CString       sWallpaper = wszWallpaper;  // 將墻紙路徑轉(zhuǎn)換為ANSI
IShellLink*   pISL;
IPersistFile* pIPF;

    // 1. 初始化COM庫(讓W(xué)indows 加載DLLs). 通常在InitInstance()中調(diào)用
    // CoInitialize ( NULL )或其它啟動(dòng)代碼。MFC 程序使用AfxOleInit() 。

    CoInitialize ( NULL );

    // 2. 使用外殼提供的Shell Link組件對(duì)象類創(chuàng)建COM對(duì)象。.
    // 第四個(gè)參數(shù)通知COM 需要什么接口(這里是IShellLink)。

    hr = CoCreateInstance ( CLSID_ShellLink,
                            NULL,
                            CLSCTX_INPROC_SERVER,
                            IID_IShellLink,
                            (void**) &pISL );

    if ( SUCCEEDED(hr) )
        {
        // 3. 設(shè)置快捷方式目標(biāo)(墻紙文件)的路徑。
        hr = pISL->SetPath ( sWallpaper );

        if ( SUCCEEDED(hr) )
            {
            // 4. 獲取這個(gè)對(duì)象的第二個(gè)接口(IPersistFile)。
            hr = pISL->QueryInterface ( IID_IPersistFile, (void**) &pIPF );

            if ( SUCCEEDED(hr) )
                {
                // 5. 調(diào)用Save() 方法保存某個(gè)文件得快捷方式。第一個(gè)參數(shù)是
                // Unicode 串。
                hr = pIPF->Save ( L"C:\\wallpaper.lnk", FALSE );

                // 6a. 釋放IPersistFile 接口。
                pIPF->Release();
                }
            }

        // 6. 釋放IShellLink 接口。
        pISL->Release();
        }

    // 輸出錯(cuò)誤信息部分這里省略。

    // 7. 收回COM 庫。MFC 程序不用這一步，它自動(dòng)完成。
    CoUninitialize();