Hinzufügen von Microsoft-Agent-Funktionen zu Ihrer Anwendung

[Microsoft Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

Für den Zugriff auf die Serverschnittstellen des Microsoft-Agents muss der Agent bereits auf dem Zielsystem installiert sein. Andere Installationen als die selbstinstallierende ausführbare Datei des Agents, z. B. der Versuch, Agent-Komponentendateien zu kopieren und zu registrieren, wird nicht unterstützt. Dadurch wird eine konsistente und vollständige Installation sichergestellt. Beachten Sie, dass die Selbstinstallationsdatei von Microsoft Agent unter Microsoft Windows 2000 und höher nicht installiert wird, da diese Versionen des Betriebssystems bereits eine eigene Version des Agents enthalten.

Um den Agent erfolgreich auf einem Zielsystem mit einem früheren Microsoft Windows-Betriebssystem zu installieren, müssen Sie außerdem sicherstellen, dass das Zielsystem über eine aktuelle Version der Microsoft Visual C++ Runtime (Msvcrt.dll), des Microsoft-Registrierungstools (Regsvr32.dll) und der Microsoft COM-DLLs verfügt. Die einfachste Möglichkeit, um sicherzustellen, dass sich die erforderlichen Komponenten auf dem Zielsystem befinden, besteht darin, dass Microsoft Internet Explorer 3.02 oder höher installiert ist. Alternativ können Sie die ersten beiden Komponenten installieren, die im Rahmen von Microsoft Visual C++ verfügbar sind. Die erforderlichen COM-DLLs können im Rahmen des Microsoft DCOM-Updates installiert werden, das auf der Microsoft-Website verfügbar ist. Weitere Informationen und Lizenzierungsinformationen zu diesen Komponenten finden Sie auf der Microsoft-Website.

Die Sprachkomponenten des Agents können auf die gleiche Weise installiert werden. Auf ähnliche Weise können Sie dieses Verfahren verwenden, um das ACS-Format der Microsoft-Zeichen zu installieren, die auf der Microsoft-Agent-Website für die Verteilung verfügbar sind. Die Zeichendateien werden automatisch im Unterverzeichnis "\Chars" von Microsoft Agent installiert.

Da die Komponenten des Microsoft-Agents als Betriebssystemkomponenten konzipiert sind, wird der Agent möglicherweise nicht deinstalliert. Wenn der Agent bereits als Teil des Windows-Betriebssystems installiert ist, wird der Selbstinstallationsschrank des Agents möglicherweise nicht installiert.

Erstellen Sie nach der Installation eine instance des Servers, um die Schnittstellen des Agents aufzurufen, und fordern Sie einen Zeiger auf eine bestimmte Schnittstelle an, die der Server mithilfe der COM-Standardkonvention unterstützt. Insbesondere stellt die COM-Bibliothek die API-Funktion CoCreateInstance bereit, die eine instance des Objekts erstellt und einen Zeiger auf die angeforderte Schnittstelle des Objekts zurückgibt. Fordern Sie einen Zeiger auf die IAgent - oder IAgentEx-Schnittstelle in Ihrem CoCreateInstance-Aufruf oder in einem nachfolgenden Aufruf von QueryInterface an.

Der folgende Code veranschaulicht dies in C/C++.

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

Wenn der Microsoft Agent-Server ausgeführt wird, stellt diese Funktion eine Verbindung mit dem Server bereit. andernfalls wird der Server gestartet.

Beachten Sie, dass die Microsoft Agent-Serverschnittstellen häufig erweiterte Schnittstellen enthalten, die das Suffix "Ex" enthalten. Diese Schnittstellen werden von ihren Nicht-Ex-Gegenstücken abgeleitet und umfassen daher die gesamte Funktionalität ihrer Nicht-Ex-Entsprechungen. Wenn Sie eines der erweiterten Features verwenden möchten, verwenden Sie die Ex-Schnittstellen.

Funktionen, die Zeiger auf BSTRs verwenden, weisen Arbeitsspeicher mithilfe von SysAllocString zu. Es liegt in der Verantwortung des Aufrufers, diesen Arbeitsspeicher mithilfe von SysFreeString freizugeben.