lineGetAgentActivityListW, fonction (tapi.h)

La fonction lineGetAgentActivityList obtient les identités des activités que l’application peut sélectionner à l’aide de lineSetAgentActivity pour indiquer la fonction que l’agent effectue réellement à l’heure actuelle.

Syntaxe

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

Paramètres

hLine

Gérez l’appareil en ligne ouverte.

dwAddressID

Adresse sur l’appareil de ligne ouverte dont l’état de l’agent doit être interrogé. Un identificateur d’adresse est associé définitivement à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

lpAgentActivityList

Pointeur vers une structure de type LINEAGENTACTIVITYLISTde taille variable. Une fois la requête 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 l'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_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALAGENTID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Remarques

Note

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.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	tapi.h
bibliothèque	Tapi32.lib
DLL	Tapi32.dll

Voir aussi

LINEAGENTACTIVITYLIST

fonctions de service de ligne supplémentaires

vue d’ensemble des informations de référence sur TAPI 2.2

lineSetAgentActivity