lineGetAgentCapsA, fonction (tapi.h)

Article
11/20/2024

La fonction lineGetAgentCaps obtient les fonctionnalités associé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 de 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é définitivement à 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 type LINEAGENTCAPSde taille variable. Une fois la requête 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 dwTotalSize membre de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

Valeur de retour

Retourne un identificateur de requête positif si l’opération asynchrone démarre ; sinon, cette fonction retourne l’une de ces valeurs d’erreur négatives :

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

Note

L’en-tête tapi.h définit lineGetAgentCaps comme 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.