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 |