fonction lineAgentSpecific (tapi.h)

Article
08/26/2023

La fonction lineAgentSpecific permet à l’application d’accéder aux fonctions propres au gestionnaire propriétaire du gestionnaire d’agent associé à l’adresse. La signification des extensions est spécifique au gestionnaire de l’agent. Chaque ensemble d’extensions liées à l’agent est identifié par un ID d’extension 128 bits universel unique qui doit être obtenu, avec la spécification de l’extension, à partir du promulgator de cette extension (généralement l’auteur du logiciel de gestionnaire d’agent sur le serveur de téléphonie). La liste des extensions prises en charge par le gestionnaire d’agent est obtenue à partir de la structure LINEAGENTCAPS retournée par lineGetAgentCaps.

Syntaxe

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

Paramètres

hLine

Gérez l’appareil de ligne ouverte.

dwAddressID

Adresse sur l’appareil de ligne ouverte. Un identificateur d’adresse est associé de façon permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

dwAgentExtensionIDIndex

Position dans la structure ExtensionIDList dans LINEAGENTCAPS de l’extension de gestionnaire d’agent appelée.

lpParams

Pointeur vers une zone de mémoire utilisée pour contenir un bloc de paramètres. Le format de ce bloc de paramètres est spécifique à l’appareil et son contenu est transmis par TAPI à et à partir de l’application de gestionnaire d’agent sur le serveur de téléphonie. Ce bloc de paramètres doit spécifier la fonction à appeler et inclure suffisamment d’espace pour que toutes les données soient retournées.

dwSize

Taille de la zone de bloc de paramètres, en octets.

Note Si lpParams est un pointeur vers une chaîne, la taille doit inclure la terminaison NULL .

Valeur retournée

Retourne un identificateur de demande positif si l’opération asynchrone démarre ; sinon, cette fonction retourne l’une des valeurs d’erreur négatives suivantes :

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Les valeurs de retour supplémentaires sont spécifiques au gestionnaire de l’agent.

Remarques

Cette opération fait partie des services de téléphonie étendus. Il permet d’accéder à une fonctionnalité spécifique au gestionnaire d’agent sans définir sa signification.

Cette fonction fournit un profil de paramètre générique. L’interprétation de la structure de paramètre est spécifique au gestionnaire. Les indications et réponses envoyées à l’application qui sont spécifiques au gestionnaire doivent utiliser le message LINE_AGENTSPECIFIC .

Un gestionnaire d’agent peut fournir l’accès à des fonctions spécifiques au gestionnaire en définissant des paramètres à utiliser avec cette fonction. Les applications qui souhaitent utiliser ces extensions doivent consulter la documentation propre au fournisseur qui décrit les extensions définies. En règle générale, une application qui s’appuie sur ces extensions n’est pas en mesure de fonctionner avec d’autres environnements de gestionnaire d’agent.