Menambahkan Fungsionalitas Agen Microsoft ke Aplikasi Anda

[Microsoft Agent tidak digunakan lagi pada Windows 7, dan mungkin tidak tersedia dalam versi Windows berikutnya.]

Untuk mengakses antarmuka server Agen Microsoft, Agen harus sudah diinstal pada sistem target. Penginstalan selain menggunakan file agen yang dapat dieksekusi sendiri, seperti mencoba menyalin dan mendaftarkan file komponen Agen, tidak didukung. Ini memastikan penginstalan yang konsisten dan lengkap. Perhatikan bahwa file penginstalan mandiri Agen Microsoft tidak akan diinstal pada Sistem operasi Microsoft Windows 2000 dan yang lebih baru karena versi sistem operasi ini sudah menyertakan versi Agen mereka sendiri.

Agar berhasil menginstal Agen pada sistem target dengan sistem operasi Microsoft Windows sebelumnya, Anda juga harus memastikan bahwa sistem target memiliki versi terbaru runtime Microsoft Visual C++ (Msvcrt.dll), alat pendaftaran Microsoft (Regsvr32.dll), dan dll Microsoft COM. Cara termampu untuk memastikan bahwa komponen yang diperlukan ada pada sistem target adalah dengan mengharuskan Microsoft Internet Explorer 3.02 atau yang lebih baru diinstal. Atau, Anda dapat menginstal dua komponen pertama yang tersedia sebagai bagian dari Microsoft Visual C++. Dll COM yang diperlukan dapat diinstal sebagai bagian dari pembaruan Microsoft DCOM, tersedia di situs web Microsoft. Anda dapat menemukan informasi lebih lanjut dan informasi lisensi untuk komponen-komponen ini di situs web Microsoft.

Komponen bahasa agen dapat diinstal dengan cara yang sama. Demikian pula, Anda dapat menggunakan teknik ini untuk menginstal format ACS karakter Microsoft yang tersedia untuk didistribusikan dari situs web Microsoft Agent. File karakter secara otomatis diinstal ke subdirektori Agen Microsoft \Chars.

Karena komponen Microsoft Agent dirancang sebagai komponen sistem operasi, Agen mungkin tidak dihapus instalannya. Demikian pula, di mana Agen sudah diinstal sebagai bagian dari sistem operasi Windows, kabinet penginstalan mandiri Agen mungkin tidak diinstal.

Setelah diinstal, untuk memanggil antarmuka Agen, buat instans server dan minta penunjuk ke antarmuka tertentu yang didukung server menggunakan konvensi COM standar. Secara khusus, pustaka COM menyediakan fungsi API, CoCreateInstance, yang membuat instans objek dan mengembalikan penunjuk ke antarmuka objek yang diminta. Minta penunjuk ke antarmuka IAgent atau IAgentEx di panggilan CoCreateInstance Anda atau dalam panggilan berikutnya ke QueryInterface.

Kode berikut mengilustrasikan ini dalam C/C++.

hRes = CoCreateInstance(CLSID_AgentServer,
                     NULL,
                     CLSCTX_SERVER,
                     IID_IAgentEx,
                     (LPVOID *)&pAgentEx);

Jika server Agen Microsoft berjalan, fungsi ini tersambung ke server; jika tidak, ia memulai server.

Perhatikan bahwa antarmuka server Microsoft Agent sering menyertakan antarmuka yang diperluas yang menyertakan akhiran "Ex". Antarmuka ini berasal dari, dan oleh karena itu mencakup semua fungsionalitas, rekan non-Ex mereka. Jika Anda ingin menggunakan salah satu fitur yang diperluas, gunakan antarmuka Ex.

Fungsi yang mengambil pointer ke BSTR mengalokasikan memori menggunakan SysAllocString. Pemanggil bertanggung jawab untuk membebaskan memori ini menggunakan SysFreeString.