lineGetAgentSessionList-Funktion (tapi.h)
Die lineGetAgentSessionList-Funktion gibt eine Liste der Agentsitzungen zurück, die für den angegebenen Agent erstellt wurden. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll und auf eine LINEPROXYREQUEST-Struktur vom Typ LINEPROXYREQUEST_GETAGENTSESSIONLIST verweist.
Syntax
LONG lineGetAgentSessionList(
HLINE hLine,
HAGENT hAgent,
LPLINEAGENTSESSIONLIST lpAgentSessionList
);
Parameter
hLine
Handle zum Leitungsgerät.
hAgent
Bezeichner des Agents, dessen Informationen abgerufen werden sollen.
lpAgentSessionList
Zeiger auf eine strukturvariable Größe vom Typ LINEAGENTSESSIONLIST. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit einer Liste der Agentsitzungen gefüllt, die für diesen Agent erstellt wurden. Vor dem Aufrufen der lineGetAgentSessionList-Funktion muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben von Informationen zur Verfügung steht.
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.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |