lineSetAgentGroup-Funktion (tapi.h)
Die lineSetAgentGroup-Funktion legt die Agentgruppen fest, in denen der Agent an einer bestimmten Adresse angemeldet ist.
Syntax
LONG lineSetAgentGroup(
HLINE hLine,
DWORD dwAddressID,
LPLINEAGENTGROUPLIST lpAgentGroupList
);
Parameter
hLine
Handle mit dem Leitungsgerät.
dwAddressID
Bezeichner der Adresse, für die die Agentinformationen geändert werden sollen. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet. Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.
lpAgentGroupList
Zeiger auf eine LINEAGENTGROUPLIST-Struktur , die die Gruppen identifiziert, in denen der aktuelle Agent an der Adresse angemeldet werden soll. Wenn der Zeiger NULL ist oder die Anzahl der Gruppen in der angegebenen Struktur 0 ist, wird der Agent von allen ACD-Gruppen abgemeldet, in denen er derzeit angemeldet ist.
Die Felder "Name" in den LINEAGENTGROUPENTRY-Elementen in der Liste werden für zwecke dieser Funktion ignoriert. die Steuerung der angemeldeten Gruppen basiert nur auf den Gruppenbezeichnerwerten.
Rückgabewert
Gibt einen positiven Anforderungsbezeichner zurück, wenn der asynchrone Vorgang gestartet wird. Andernfalls gibt die Funktion einen der folgenden negativen Fehlerwerte zurück:
LINEERR_INVALADDRESSID, LINEERR_INVALADDRESSSTATE, LINEERR_INVALAGENTGROUP, LINEERR_INVALAGENTID, LINEERR_INVALLINEHANDLE, LINEERR_INVALPARAM, LINEERR_INVALPASSWORD, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |