Partager via


lineSetAgentState, fonction (tapi.h)

La fonction lineSetAgentState définit l’état de l’agent associé à une adresse particulière.

Syntaxe

LONG lineSetAgentState(
  HLINE hLine,
  DWORD dwAddressID,
  DWORD dwAgentState,
  DWORD dwNextAgentState
);

Paramètres

hLine

Gérez l’appareil de ligne.

dwAddressID

Identificateur de l’adresse pour laquelle les informations de l’agent doivent être modifiées. Un identificateur d’adresse est associé de manière permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

dwAgentState

Nouvel état de l’agent. Doit être l’une des constantes LINEAGENTSTATE_, ou zéro pour laisser l’état de l’agent inchangé et modifier uniquement l’état suivant.

dwNextAgentState

État de l’agent qui doit être automatiquement défini lorsque l’appel actuel sur l’adresse devient inactif. Par exemple, s’il est connu que le travail après appel doit être effectué, ce champ peut être défini sur LINEAGENTSTATE_WORKAFTERCALL afin qu’un nouvel appel ne soit pas affecté à l’agent après l’appel actuel. Doit être l’une des constantes LINEAGENTSTATE_, ou zéro pour utiliser l’état suivant par défaut configuré pour l’agent.

Valeur retournée

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

LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

Fonctions de service de ligne supplémentaires

Vue d’ensemble de la référence TAPI 2.2