Cara Membuat Sampel
Untuk membuat sampel COM, lingkungan komputer harus disiapkan untuk membangun aplikasi Microsoft Win32 C++.
Menyiapkan Komputer untuk Membuat Sampel COM
Lingkungan komputer harus disiapkan dengan pengkompilasi, linker, dan pengkompilasi sumber daya C++ 32-bit yang diinstal dengan benar yang kompatibel dengan Microsoft Visual C++ 4.x atau yang lebih baru, dan Windows SDK yang diinstal dengan benar. Yang terbaik adalah menginstal Windows SDK terakhir. Windows SDK menyediakan file pustaka .h include dan .lib yang diperlukan untuk fungsionalitas COM yang dikodekan dalam sampel.
Agar berhasil menjalankan sampel Remclien, Freserve, dan Freclien memerlukan fasilitas sistem yang tersedia di sistem operasi Windows: Windows Server 2003, Windows XP, Windows 2000, atau Windows NT 4.0. Sampel Remclien, Freserve, dan Freclien akan dibuat tetapi tidak akan berjalan pada sistem operasi Windows Me, Windows 98, atau Windows 95 kecuali DISTRIBUTED COM (DCOM) dan COM utas gratis adalah bagian dari sistem operasi. Dukungan ini tersedia untuk sistem operasi Windows Me, Windows 98, dan Windows 95 di add-on DCOM95.
Setiap direktori sampel memiliki file sumber yang diperlukan untuk membangun dan menjalankan sampel. Direktori sampel induk memiliki file Makeall.bat, yang dapat Anda jalankan dari prompt perintah untuk membuat semua sampel kode di cabang di bawah ini. Untuk informasi selengkapnya, lihat file Makeall.bat. Jika lingkungan Anda disiapkan untuk membangun aplikasi Win32 C++, Anda cukup menjalankan Makeall.bat dari direktori tempatnya berada untuk membangun semua sampel kode di cabang di bawah ini. Makeall memastikan urutan yang benar ke build sehingga semua dependensi sampel kode terpenuhi.
Direktori utama juga memiliki makefile yang membangun semua sampel kode tutorial menggunakan opsi yang mirip dengan yang didukung oleh Makeall.bat. Untuk informasi selengkapnya, lihat makefile ini. Makefile ini mengasumsikan bahwa seluruh cabang sampel kode diinstal sebagai bagian dari Windows SDK. Saat ini lokasi ini memiliki jalur yang mirip dengan D:\MSSDK\SAMPLES\COM\TUTSAMP, di mana D: mewakili drive penginstalan. Jika Anda telah mengekstrak cabang sampel kode tutorial (misalnya, COM direktori COM dan subdirektorinya) ke lokasi lain di luar Windows SDK (atau jika Anda mendapatkan sampel yang ditetapkan sebagai unduhan terpisah dari situs web Microsoft), maka gunakan Makeall.bat untuk mengkompilasi semua sampel di cabang. Secara umum, Makeall.bat disarankan. File Logmall.bat juga disediakan. Ini melakukan hal yang sama seperti file batch Makeall kecuali bahwa ia mencatat semua output kompilasi untuk Errorlog.txt file di direktori tutorial utama.
Dua file batch, Regall.bat dan Unregall.bat, juga disediakan di direktori utama untuk mendaftar dan membatalkan pendaftaran semua server COM dalam seri sampel kode tutorial. Untuk mendaftarkan semua server, jalankan file Regall.bat dari direktori utama. Untuk membatalkan pendaftaran semua server, jalankan Unregall.bat dengan cara yang sama. File batch ini memerlukan build sebelumnya dari sampel kode REGISTER, MARSHAL, DLLSERVE, LICSERVE, LOCSERVE, APTSERVE, FRESERVE, dan CONSERVE. Jika Anda melakukan build normal sampel kode, server makefiles akan secara otomatis mendaftarkan server. Dalam hal ini, tidak perlu menjalankan file batch Regall.
Jalankan file batch Cleanall.bat untuk melakukan Cleanall lengkap dari semua Sampel Tutorial COM.
Peringatan
File batch ini menghapus semua file proyek Visual Studio dan file pekerjaan sementara lainnya yang dibuat oleh Visual C++ dalam sampel. Semua server COM yang dibangun dalam sampel kode tutorial tidak terdaftar dari registri. Semua file executable dan .dll dihapus. Semua file simbol debug dihapus. File yang dihasilkan di berbagai lingkungan build juga dihapus.
Jalankan 'Makeall Clean' untuk melakukan pembersihan yang lebih cepat, tetapi lebih sederhana dari semua sampel kode. Operasi pembersihan ini tidak mencoba menjadi komprehensif seperti yang dilakukan oleh Cleanall.bat. File .obj dihapus, tetapi biner output dipertahankan. Server COM tidak terdaftar dari registri.
Seri sampel ini berasal sebagai bagian integral dari Windows SDK, oleh karena itu narasi tutorial mengasumsikan lingkungan dengan Windows SDK diinstal dengan benar.
Namun, rilis Microsoft Visual C++ versi 4.0 dan yang lebih baru juga dapat menyediakan file pustaka .h include dan .lib yang diperlukan untuk kompilasi. Dalam kasus seperti itu, penginstalan Windows SDK mungkin tidak diperlukan untuk mengkompilasi sampel.
Untuk informasi selengkapnya dan detail build sampel lengkap, lihat: