fonction lineGetAgentStatusA (tapi.h)

Article
03/02/2024

La fonction lineGetAgentStatus obtient les status liées à l’agent sur l’adresse spécifiée.

Syntaxe

LONG lineGetAgentStatusA(
  HLINE             hLine,
  DWORD             dwAddressID,
  LPLINEAGENTSTATUS lpAgentStatus
);

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.

lpAgentStatus

Pointeur vers une structure de taille variable de type LINEAGENTSTATUS. Une fois la demande terminée, cette structure est remplie d’informations status de l’agent. Avant d’appeler lineGetAgentStatus, 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.

Note Si les paramètres de taille de la structure ne sont pas corrects, il est possible que la mémoire soit remplacée. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique allocation de mémoire .

Valeur retournée

Retourne un identificateur de demande positif si l’opération asynchrone démarre ; sinon, une de ces valeurs d’erreur négatives :

LINEERR_INVALADDRESSID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Remarques

Notes

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