Lägga till Microsoft Agent-funktioner i ditt program

[Microsoft Agent är inaktuell från och med Windows 7 och kan vara otillgänglig i efterföljande versioner av Windows.]

För att få åtkomst till Microsoft-agentens servergränssnitt måste agenten redan vara installerad på målsystemet. Installation annat än att använda agentens självinstallerande körbara fil, till exempel försök att kopiera och registrera agentkomponentfiler, stöds inte. Detta säkerställer en konsekvent och fullständig installation. Observera att Microsoft Agent-självinstallationsfilen inte installeras på Microsoft Windows 2000 och senare operativsystem eftersom dessa versioner av operativsystemet redan innehåller sin egen version av Agent.

Om du vill installera Agent på ett målsystem med ett tidigare Microsoft Windows-operativsystem måste du också se till att målsystemet har en ny version av Microsoft Visual C++-körningen (Msvcrt.dll), Microsofts registreringsverktyg (Regsvr32.dll) och Microsoft COM-dlls. Det enklaste sättet att se till att nödvändiga komponenter finns i målsystemet är att kräva att Microsoft Internet Explorer 3.02 eller senare installeras. Du kan också installera de två första komponenterna som är tillgängliga som en del av Microsoft Visual C++. Nödvändiga COM-dll:er kan installeras som en del av Microsoft DCOM-uppdateringen, som är tillgänglig på Microsofts webbplats. Du hittar ytterligare information och licensieringsinformation för dessa komponenter på Microsofts webbplats.

Agentens språkkomponenter kan installeras på samma sätt. På samma sätt kan du använda den här tekniken för att installera ACS-formatet för De Microsoft-tecken som är tillgängliga för distribution från Microsoft Agent-webbplatsen. Teckenfilerna installeras automatiskt i underkatalogen Microsoft Agent \Chars.

Eftersom Microsoft-agentens komponenter är utformade som operativsystemkomponenter kanske agenten inte avinstalleras. På samma sätt, när agenten redan är installerad som en del av Windows-operativsystemet, kanske agentens självinstallationsskåp inte installeras.

När du har installerat det kan du anropa agentens gränssnitt genom att skapa en instans av servern och begära en pekare till ett specifikt gränssnitt som servern stöder med hjälp av com-standardkonventionen. I synnerhet tillhandahåller COM-biblioteket en API-funktion, CoCreateInstance, som skapar en instans av objektet och returnerar en pekare till objektets begärda gränssnitt. Begär en pekare till gränssnittet IAgent eller IAgentEx i ditt CoCreateInstance--anrop eller i ett efterföljande anrop till QueryInterface.

Följande kod illustrerar detta i C/C++.

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

Om Microsoft Agent-servern körs ansluter den här funktionen till servern. annars startar den servern.

Observera att Microsoft Agent-servergränssnitten ofta innehåller utökade gränssnitt som innehåller ett "Ex"-suffix. Dessa gränssnitt härstammar från sina icke-Ex-motsvarigheter och inkluderar därför all deras funktionalitet. Om du vill använda någon av de utökade funktionerna använder du Ex-gränssnitten.

Funktioner som pekar på BSTR allokerar minne med hjälp av SysAllocString. Det är anroparens ansvar att frigöra det här minnet med hjälp av SysFreeString.