Ajout de fonctionnalités d’agent Microsoft à votre application

[Microsoft Agent est déconseillé à partir de Windows 7 et peut être indisponible dans les versions ultérieures de Windows.]

Pour accéder aux interfaces serveur de Microsoft Agent, l’agent doit déjà être installé sur le système cible. L’installation autre que l’utilisation du fichier exécutable auto-installable de l’Agent, comme la tentative de copie et d’inscription des fichiers de composants de l’agent, n’est pas prise en charge. Cela garantit une installation cohérente et complète. Notez que le fichier d’installation automatique de l’Agent Microsoft ne sera pas installé sur les systèmes d’exploitation Microsoft Windows 2000 et versions ultérieures, car ces versions du système d’exploitation incluent déjà leur propre version de l’Agent.

Pour installer correctement l’Agent sur un système cible avec un système d’exploitation Microsoft Windows antérieur, vous devez également vous assurer que le système cible dispose d’une version récente du runtime Microsoft Visual C++ (Msvcrt.dll), de l’outil d’inscription Microsoft (Regsvr32.dll) et des dll Microsoft COM. Le moyen le plus simple de s’assurer que les composants nécessaires se trouvent sur le système cible consiste à exiger que Microsoft Internet Explorer 3.02 ou version ultérieure soit installé. Vous pouvez également installer les deux premiers composants disponibles dans le cadre de Microsoft Visual C++. Les dll COM nécessaires peuvent être installées dans le cadre de la mise à jour microsoft DCOM, disponible sur le site web microsoft. Vous trouverez plus d’informations et d’informations sur les licences pour ces composants sur le site web de Microsoft.

Les composants linguistiques de l’agent peuvent être installés de la même façon. De même, vous pouvez utiliser cette technique pour installer le format ACS des caractères Microsoft disponibles pour distribution à partir du site web de Microsoft Agent. Les fichiers de caractères s’installent automatiquement dans le sous-répertoire Microsoft Agent \Chars.

Étant donné que les composants de Microsoft Agent sont conçus en tant que composants du système d’exploitation, il se peut que l’Agent ne soit pas désinstallé. De même, lorsque l’Agent est déjà installé dans le cadre du système d’exploitation Windows, l’armoire à installation automatique de l’Agent peut ne pas s’installer.

Une fois installé, pour appeler les interfaces de l’Agent, créez une instance du serveur et demandez un pointeur vers une interface spécifique prise en charge par le serveur à l’aide de la convention COM standard. En particulier, la bibliothèque COM fournit une fonction d’API, CoCreateInstance, qui crée une instance de l’objet et retourne un pointeur vers l’interface demandée de l’objet. Demandez un pointeur vers l’interface IAgent ou IAgentEx dans votre appel CoCreateInstance ou dans un appel suivant à QueryInterface.

Le code suivant illustre cela en C/C++.

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

Si le serveur Microsoft Agent est en cours d’exécution, cette fonction se connecte au serveur ; sinon, il démarre le serveur.

Notez que les interfaces serveur Microsoft Agent incluent souvent des interfaces étendues qui incluent un suffixe « Ex ». Ces interfaces sont dérivées de et incluent donc toutes les fonctionnalités de leurs équivalents non Ex. Si vous souhaitez utiliser l’une des fonctionnalités étendues, utilisez les interfaces Ex.

Les fonctions qui prennent des pointeurs vers les BSTR allouent de la mémoire à l’aide de SysAllocString. Il incombe à l’appelant de libérer cette mémoire à l’aide de SysFreeString.