fonction lineGetAgentActivityListA (tapi.h)

Article
08/26/2023

La fonction lineGetAgentActivityList obtient les identités des activités que l’application peut sélectionner à l’aide de lineSetAgentActivity pour indiquer la fonction réellement exécutée par l’agent en ce moment.

Syntaxe

LONG lineGetAgentActivityListA(
  HLINE                   hLine,
  DWORD                   dwAddressID,
  LPLINEAGENTACTIVITYLIST lpAgentActivityList
);

Paramètres

hLine

Gérez l’appareil de ligne ouverte.

dwAddressID

Adresse sur l’appareil en ligne ouverte dont l’agent status doit être interrogé. 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.

lpAgentActivityList

Pointeur vers une structure de taille variable de type LINEAGENTACTIVITYLIST. Une fois la demande terminée, cette structure est remplie avec une liste des codes d’activité de l’agent qui peuvent être sélectionnés à l’aide de lineSetAgentActivity. Avant d’appeler lineGetAgentActivityList, 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_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALAGENTID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Remarques

Notes

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