fonction lineGetAgentCapsA (tapi.h)
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.
Configuration requise
Plateforme cible | Windows |
En-tête | tapi.h |
Bibliothèque | Tapi32.lib |
DLL | Tapi32.dll |
Voir aussi
Fonctions de service de ligne supplémentaires