Uygulamanıza Microsoft Agent İşlevselliği Ekleme

[Microsoft Agent, Windows 7 itibariyle kullanım dışıdır ve sonraki Windows sürümlerinde kullanılamayabilir.]

Microsoft Agent'ın sunucu arabirimlerine erişmek için, Aracı'nın hedef sistemde zaten yüklü olması gerekir. Aracı bileşen dosyalarını kopyalamaya ve kaydetmeye çalışma gibi Aracı'nın kendi kendine yüklenen yürütülebilir dosyasını kullanma dışında yükleme desteklenmez. Bu, tutarlı ve eksiksiz bir yükleme sağlar. İşletim sisteminin bu sürümleri zaten kendi Agent sürümünü içerdiğinden, Microsoft Agent'ın kendi kendini yükleyen dosyasının Microsoft Windows 2000 ve sonraki işletim sistemlerine yüklenmeyeceğini unutmayın.

Aracıyı önceki bir Microsoft Windows işletim sistemine sahip bir hedef sisteme başarıyla yüklemek için, hedef sistemin Microsoft Visual C++ çalışma zamanının (Msvcrt.dll), Microsoft kayıt aracının (Regsvr32.dll) ve Microsoft COM dll'lerinin son sürümüne sahip olduğundan da emin olmanız gerekir. Gerekli bileşenlerin hedef sistemde olduğundan emin olmak için en kolay yol, Microsoft Internet Explorer 3.02 veya sonraki bir sürümünün yüklü olmasını istemektir. Alternatif olarak, Microsoft Visual C++ kapsamında kullanılabilen ilk iki bileşeni yükleyebilirsiniz. Gerekli COM dll'leri, Microsoft web sitesinde bulunan Microsoft DCOM güncelleştirmesinin bir parçası olarak yüklenebilir. Bu bileşenlerle ilgili daha fazla bilgi ve lisans bilgilerini Microsoft web sitesinde bulabilirsiniz.

Temsilcinin dil bileşenleri aynı şekilde yüklenebilir. Benzer şekilde, Microsoft Agent web sitesinden dağıtılabilir Microsoft karakterlerinin ACS biçimini yüklemek için bu tekniği kullanabilirsiniz. Karakter dosyaları otomatik olarak Microsoft Agent \Chars alt dizinine yüklenir.

Microsoft Agent'ın bileşenleri işletim sistemi bileşenleri olarak tasarlandığından Aracı kaldırılamayabilir. Benzer şekilde, Aracı'nın Windows işletim sisteminin bir parçası olarak zaten yüklü olduğu durumlarda Aracı kendi kendine yükleme kabini yüklenmeyebilir.

Yüklendikten sonra, Aracı'nın arabirimlerini çağırmak için sunucunun bir örneğini oluşturun ve standart COM kuralını kullanarak sunucunun desteklediği belirli bir arabirime yönelik bir işaretçi isteyin. Özellikle COM kitaplığı, nesnesinin bir örneğini oluşturan ve nesnenin istenen arabirimine bir işaretçi döndüren coCreateInstancebir API işlevi sağlar. CoCreateInstance çağrınızdaki veya sonraki bir QueryInterfaceçağrınızdaki IAgent veya IAgentEx arabirimine bir işaretçi isteyin.

Aşağıdaki kod bunu C/C++ dilinde gösterir.

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

Microsoft Agent sunucusu çalışıyorsa, bu işlev sunucuya bağlanır; aksi takdirde, sunucuyu başlatır.

Microsoft Agent sunucu arabirimlerinin genellikle "Ex" soneki içeren genişletilmiş arabirimler içerdiğini unutmayın. Bu arabirimler, Ex kategorisine girmeyen muadillerinden türetilir ve bu nedenle tüm işlevselliklerini içerir. Genişletilmiş özelliklerden herhangi birini kullanmak istiyorsanız Ex arabirimlerini kullanın.

BSTR'lere işaretçi alan işlevler, SysAllocStringkullanarak bellek ayırır. SysFreeStringkullanarak bu belleği boşaltmak çağıranın sorumluluğundadır.