lineGetQueueInfo-Funktion (tapi.h)

Artikel
03/04/2024

Die lineGetQueueInfo-Funktion gibt eine Struktur mit den ACD-Informationen zurück, die einer bestimmten Warteschlange zugeordnet sind. Es generiert eine LINE_PROXYREQUEST Nachricht, die an einen registrierten Proxyfunktionshandler gesendet werden soll, wobei auf eine LINEPROXYREQUEST-Struktur vom Typ LINEPROXYREQUEST_GETQUEUEINFO verwiesen wird.

Syntax

LONG lineGetQueueInfo(
  HLINE           hLine,
  DWORD           dwQueueID,
  LPLINEQUEUEINFO lpLineQueueInfo
);

Parameter

hLine

Handle mit dem Leitungsgerät.

dwQueueID

Bezeichner der Warteschlange, deren Informationen abgerufen werden sollen.

lpLineQueueInfo

Zeiger auf eine Struktur vom Typ LINEQUEUEINFO. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit den Warteschlangenstatistiken gefüllt. Vor dem Aufrufen von lineGetQueueInfo muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, die 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 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.