lineGetGroupListA-Funktion (tapi.h)

Artikel
08/26/2023

Die lineGetGroupList-Funktion gibt eine Liste der ACD-Gruppen zurück, die im ACD-System verfügbar sind. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll und auf eine LINEPROXYREQUEST-Struktur vom Typ LINEPROXYREQUEST_GETGROUPLIST verweist.

Syntax

LONG lineGetGroupListA(
  HLINE                hLine,
  LPLINEAGENTGROUPLIST lpGroupList
);

Parameter

hLine

Handle mit dem Leitungsgerät.

lpGroupList

Zeiger auf eine strukturvariable Größe vom Typ LINEAGENTGROUPLIST. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit einer Liste der verfügbaren ACD-Gruppen gefüllt. Vor dem Aufrufen der lineGetGroupList-Funktion muss die Anwendung das dwTotalSize-Element dieser Struktur so festlegen, dass die Menge an Arbeitsspeicher angegeben wird, der TAPI für die Rückgabe von Informationen zur Verfügung steht.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema Speicherzuordnung .

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

Hinweis

Der tapi.h-Header definiert lineGetGroupList als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.