lineGetAgentStatusA, fonction (tapi.h)

Article
11/20/2024

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

Syntaxe

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

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.

lpAgentStatus

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

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

Valeur de retour

Retourne un identificateur de requête positif si l’opération asynchrone démarre ; sinon, l’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

Note

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.

Exigences

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

Voir aussi

LINEAGENTSTATUS

fonctions de service de ligne supplémentaires

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

Partager via