fonction lineGetAgentCapsA (tapi.h)

Article
08/26/2023

La fonction lineGetAgentCaps obtient les fonctionnalités liées à l’agent prises en charge sur l’appareil de ligne spécifié. Si un agent spécifique est nommé, les fonctionnalités incluent une liste des groupes ACD dans lesquels l’agent est autorisé à se connecter.

Syntaxe

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

Paramètres

hLineApp

Gérez l’inscription de l’application avec TAPI.

dwDeviceID

Périphérique de ligne contenant l’adresse à interroger.

dwAddressID

Adresse sur l’appareil de ligne donné dont les fonctionnalités doivent être interrogées. 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.

dwAppAPIVersion

Version d’API la plus élevée prise en charge par l’application. Il ne doit pas s’agir de la valeur négociée à l’aide de lineNegotiateAPIVersion sur l’appareil interrogé.

lpAgentCaps

Pointeur vers une structure de taille variable de type LINEAGENTCAPS. Une fois la demande terminée, cette structure est remplie d’informations sur les fonctionnalités de l’agent. Avant d’appeler lineGetAgentCaps, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

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_BADDEVICEID, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALADDRESSID, LINEERR_INVALAPPHANDLE, LINEERR_INVALPOINTER, LINEERR_NODEVICE, LINEERR_NODRIVER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Remarques

Notes

L’en-tête tapi.h définit lineGetAgentCaps comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.