lineSetAgentState-Funktion (tapi.h)

Die lineSetAgentState-Funktion legt den Agentstatus fest, der einer bestimmten Adresse zugeordnet ist.

Syntax

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

Parameter

hLine

Handle zum Leitungsgerät.

dwAddressID

Bezeichner der Adresse, für die die Agent-Informationen geändert werden sollen. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

dwAgentState

Neuer Agent-Status. Muss eine der LINEAGENTSTATE_ Konstanten oder null sein, um den Agentstatus unverändert zu lassen und nur den nächsten Zustand zu ändern.

dwNextAgentState

Der Agentstatus, der automatisch festgelegt werden soll, wenn der aktuelle Aufruf der Adresse in den Leerlauf wechselt. Wenn beispielsweise bekannt ist, dass nach dem Aufruf Arbeit ausgeführt werden muss, kann dieses Feld auf LINEAGENTSTATE_WORKAFTERCALL festgelegt werden, sodass dem Agent nach dem aktuellen Aufruf kein neuer Aufruf zugewiesen wird. Muss eine der LINEAGENTSTATE_ Konstanten oder null sein, um den für den Agent konfigurierten Standardzustand zu verwenden.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird. Andernfalls gibt die Funktion einen der folgenden negativen Fehlerwerte zurück:

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

Anforderungen

Weitere Informationen

Ergänzende Zeilendienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz