共用方式為


將 Microsoft Agent 功能新增至您的應用程式

[從 Windows 7 開始,Microsoft Agent 已被取代,而且在後續版本的 Windows 中可能無法使用。]

若要存取 Microsoft Agent 的伺服器介面,Agent 必須已安裝在目標系統上。 不支援使用 Agent 自我安裝可執行檔以外的安裝,例如嘗試複製和註冊 Agent 元件檔案。 這可確保一致且完整的安裝。 請注意,Microsoft Agent 自我安裝檔案不會安裝在 Microsoft Windows 2000 和更新版本的作業系統上,因為這些版本的作業系統已經包含自己的 Agent 版本。

若要在具有舊版 Microsoft Windows 作業系統的目標系統上成功安裝 Agent,您也必須確定目標系統具有最新版的 Microsoft Visual C++ 執行時間 (Msvcrt.dll) 、Microsoft 註冊工具 (Regsvr32.dll) 和 Microsoft COM dll。 若要確保目標系統上有必要的元件,最簡單的方法是要求安裝 Microsoft Internet Explorer 3.02 或更新版本。 或者,您也可以安裝前兩個元件,以作為Microsoft Visual C++的一部分。 必要的 COM dll 可以安裝為 Microsoft DCOM 更新的一部分,可在 Microsoft 網站取得。 您可以在 Microsoft 網站找到這些元件的進一步資訊和授權資訊。

代理程式的語言元件可以安裝方式相同。 同樣地,您可以使用這項技術來安裝可從 Microsoft Agent 網站散發的 Microsoft 字元 ACS 格式。 字元檔案會自動安裝至 Microsoft Agent \Chars 子目錄。

因為 Microsoft Agent 的元件設計成作業系統元件,所以 Agent 可能不會卸載。 同樣地,當 Agent 已安裝為 Windows 作業系統的一部分時,代理程式自我安裝封包可能無法安裝。

安裝之後,若要呼叫 Agent 的介面,請建立伺服器的實例,並要求伺服器使用標準 COM 慣例支援之特定介面的指標。 特別是,COM 程式庫會提供 API 函式 CoCreateInstance,該函式會建立 物件的實例,並傳回物件的要求介面指標。 在CoCreateInstance呼叫或查詢Interface的後續呼叫中,要求IAgentIAgentEx介面的指標。

下列程式碼說明 C/C++ 中的這一點。

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

如果 Microsoft Agent 伺服器正在執行,此函式會連線到伺服器;否則,它會啟動伺服器。

請注意,Microsoft Agent 伺服器介面通常包含包含 「Ex」 尾碼的擴充介面。 這些介面衍生自 ,因此包含其非 Ex 對應專案的所有功能。 如果您想要使用任何擴充功能,請使用 Ex 介面。

使用 SysAllocString取得 BDR 指標的函式會配置記憶體。 呼叫者必須負責使用 SysFreeString釋放此記憶體。