如何建置範例

若要建置 COM 範例,電腦環境必須設定為建置 Microsoft Win32 C++ 應用程式。

準備電腦以建立 COM 範例

電腦環境必須設定正確安裝的 32 位 C++ 編譯器、連結器和資源編譯器,且與 Microsoft Visual C++ 4.x 或更新版本相容,以及正確安裝的 Windows SDK。 最好是最後安裝 Windows SDK。 Windows SDK 提供範例中編碼之 COM 功能所需的 .h include 和 .lib 程式庫檔案。

若要成功執行 Remclien、Freserve 和 Freclien 範例,需要 Windows 作業系統中可用的系統功能:Windows Server 2003、Windows XP、Windows 2000 或 Windows NT 4.0。 Remclien、Freserve 和 Freclien 範例將會建置,但不會在 Windows Me、Windows 98 或 Windows 95 作業系統上執行,除非 Distributed COM (DCOM) 和免費的執行緒 COM 是作業系統的一部分。 此支援適用于 DCOM95 附加元件的 Windows Me、Windows 98 和 Windows 95 作業系統。

每個範例目錄都有建置和執行範例所需的原始程式檔。 父範例目錄具有Makeall.bat檔案,您可以從命令提示字元執行,讓下列分支中的所有程式碼範例。 如需詳細資訊,請參閱Makeall.bat檔案。 如果您的環境設定為建置 Win32 C++ 應用程式,您只要從其所在目錄執行Makeall.bat,即可在下列分支中建置所有程式碼範例。 Makeall 可確保組建的正確順序,以便滿足所有程式碼範例相依性。

主目錄也有 makefile,其會使用類似Makeall.bat所支援的選項來建置所有教學課程程式碼範例。 如需詳細資訊,請參閱此 Makefile。 這個 makefile 假設整個程式碼範例分支會安裝為 Windows SDK 的一部分。 目前這個位置的路徑與 D:\MSSDK\SAMPLES\COM\TUTSAMP類似,其中 D: 代表安裝磁片磁碟機。 例如,如果您擷取教學課程程式碼範例分支 (,COM 目錄 COM 及其子目錄) 到 Windows SDK 外部的另一個位置 (,或如果您從 Microsoft 網站取得範例集作為個別下載) ,請使用 Makeall.bat 來編譯分支中的所有範例。 一般而言,建議Makeall.bat。 也會提供Logmall.bat檔案。 它與 Makeall 批次檔相同,不同之處在于它會將所有編譯輸出記錄到主要教學課程目錄中的檔案Errorlog.txt。

主要目錄中也提供兩個批次檔Regall.bat和Unregall.bat,以註冊和取消註冊教學課程程式碼範例系列中的所有 COM 伺服器。 若要註冊所有伺服器,請從主目錄執行 Regall.bat 檔案。 若要取消註冊所有伺服器,請以相同方式執行Unregall.bat。 這些批次檔需要先前的 REGISTER、MARSHAL、DLLSERVE、LICSERVE、LOCSERVE、APTSERVE、FRESERVE 和 CONSERVE 程式碼範例。 如果您執行程式碼範例的一般組建,伺服器 makefiles 會自動註冊伺服器。 在此情況下,不需要執行 Regall 批次檔。

執行Cleanall.bat批次檔,以完整清除所有 COM 教學課程範例。

警告

此批次檔會刪除範例中 Visual C++ 建立的所有 Visual Studio 專案檔和其他暫存工作檔案。 在教學課程程式碼範例中建置的所有 COM 伺服器都會從登錄取消註冊。 刪除所有可執行檔 exe 和 .dll 檔案。 所有偵錯符號檔都會遭到刪除。 也會刪除在各種組建環境中產生的檔案。

 

執行 'Makeall Clean' 以加快執行速度,但更適中、清除所有程式碼範例。 此清除作業不會嘗試與Cleanall.bat所執行一樣完整。 刪除 .obj 檔案,但會保留輸出二進位檔。 COM 伺服器不會從登錄取消註冊。

此範例系列源自于 Windows SDK 的一部分,因此教學課程敘述假設已安裝 Windows SDK 的環境。

不過,Microsoft Visual C++ 4.0 版和更新版本的版本也可能提供編譯所需的 .h include 和 .lib 程式庫檔案。 在這種情況下,可能需要安裝 Windows SDK 才能編譯範例。

如需詳細資訊和完整的範例組建詳細資料,請參閱:

環境設定

Makefiles

使用 Visual Studio

擷取程式碼範例

編碼樣式慣例