lineGetAgentGroupListA-Funktion (tapi.h)

Artikel
03/02/2024

Die lineGetAgentGroupList-Funktion ruft die Identitäten von Agentgruppen (Kombination aus Warteschlange, Supervisor, Qualifikationsebene usw.) ab, bei denen sich der derzeit auf der Arbeitsstation angemeldete Agent beim automatischen Anrufverteiler anmelden darf.

Syntax

LONG lineGetAgentGroupListA(
  HLINE                hLine,
  DWORD                dwAddressID,
  LPLINEAGENTGROUPLIST lpAgentGroupList
);

Parameter

hLine

Handle für das Open Line-Gerät.

dwAddressID

Adresse auf dem Offenzeilengerät, dessen Agent status abgefragt werden soll.

lpAgentGroupList

Zeiger auf eine strukturvariable Größe vom Typ LINEAGENTGROUPLIST. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit einer Liste der Agentgruppen gefüllt, bei denen sich der Agent zu diesem Zeitpunkt anmelden kann (die ggf. alle Gruppen enthalten sollte, bei denen der Agent bereits angemeldet ist).

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird. Andernfalls gibt diese Funktion einen der folgenden negativen Fehlerwerte zurück:

LINEERR_INVALADDRESSID, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Hinweise

Hinweis

Der tapi.h-Header definiert lineGetAgentGroupList 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.