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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |