lineSetAgentStateEx-Funktion (tapi.h)
Die lineSetAgentStateEx-Funktion legt den Agentstatus fest, der einem bestimmten Agenthandle zugeordnet ist. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll, wobei auf eine LINEPROXYREQUEST-Struktur vom Typ LINEPROXYREQUEST_SETAGENTSTATEEX verwiesen wird.
Syntax
LONG lineSetAgentStateEx(
HLINE hLine,
HAGENT hAgent,
DWORD dwAgentState,
DWORD dwNextAgentState
);
Parameter
hLine
Handle mit dem Leitungsgerät.
hAgent
Bezeichner des Agents, dessen Informationen geändert werden sollen.
dwAgentState
Neuer Agentstatus. Muss eine der LINEAGENTSTATEEX_ Konstanten oder null sein, damit der Agentzustand unverändert bleibt und nur der nächste Zustand geändert wird.
dwNextAgentState
Nächster Agentstatus. Muss eine der LINEAGENTSTATEEX_ Konstanten oder null sein.
Rückgabewert
Gibt einen Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird; Andernfalls gibt die Funktion einen der folgenden Fehlerwerte zurück:
LINEERR_INVALAGENTSTATE, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |