lineGetAgentInfo-Funktion (tapi.h)
Die lineGetAgentInfo-Funktion gibt eine Struktur mit den ACD-Informationen zurück, die einem bestimmten Agenthandle zugeordnet sind. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll und auf eine LINEPROXYREQUEST-Struktur vom Typ LINEPROXYREQUEST_GETAGENTINFO verweist.
Syntax
LONG lineGetAgentInfo(
HLINE hLine,
HAGENT hAgent,
LPLINEAGENTINFO lpAgentInfo
);
Parameter
hLine
Handle mit dem Leitungsgerät.
hAgent
Bezeichner des Agents, dessen Informationen abgerufen werden sollen.
lpAgentInfo
Zeiger auf eine Struktur vom Typ LINEAGENTINFO. Wenn die Anforderung erfolgreich ist, wird diese Struktur mit den Agentstatistiken gefüllt.
Rückgabewert
Gibt einen Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird; Andernfalls gibt die Funktion einen der folgenden Fehlerwerte zurück:
LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Hinweise
Vor dem Aufrufen der lineGetAgentInfo-Funktion sollte die Anwendung das dwTotalSize-Element der LINEAGENTINFO-Struktur so festlegen, dass die Menge an Arbeitsspeicher angegeben wird, der TAPI für die Rückgabe von Informationen zur Verfügung steht.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |