lineGetQueueListA-Funktion (tapi.h)

Artikel
11/20/2024

Die lineGetQueueList--Funktion gibt eine Liste der Warteschlangen zurück, die einer bestimmten ACD-Gruppe zugeordnet sind. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll, wobei auf eine LINEPROXYREQUEST- Struktur des Typs LINEPROXYREQUEST_GETQUEUELIST verwiesen wird.

Syntax

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

Parameter

hLine

Behandeln sie das Leitungsgerät.

lpGroupID

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

lpQueueList

Zeiger auf eine variabel angepasste Struktur des Typs LINEQUEUELIST. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit einer Liste von Warteschlangen gefüllt. Vor dem Aufrufen lineGetQueueList-muss die Anwendung die dwTotalSize Mitglied dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher für TAPI für die Rückgabe von Informationen verfügbar ist.

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

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.

Bemerkungen

Anmerkung

Der header tapi.h 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.