lineGetQueueListA-Funktion (tapi.h)

Artikel
03/02/2024

Die lineGetQueueList-Funktion gibt eine Liste von Warteschlangen zurück, die einer bestimmten ACD-Gruppe zugeordnet sind. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll und auf eine LINEPROXYREQUEST-Struktur vom Typ LINEPROXYREQUEST_GETQUEUELIST verweist.

Syntax

LONG lineGetQueueListA(
  HLINE           hLine,
  LPGUID          lpGroupID,
  LPLINEQUEUELIST lpQueueList
);

Parameter

hLine

Handle zum Leitungsgerät.

lpGroupID

Zeiger auf die GUID, die die Gruppe identifiziert, für die die Liste der Warteschlangen angefordert wird.

lpQueueList

Zeiger auf eine strukturvariable Größe vom Typ LINEQUEUELIST. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit einer Liste von Warteschlangen gefüllt. Vor dem Aufrufen von lineGetQueueList muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben 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 speicherbelegung .

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 lineGetQueueList 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 Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.