lineGetAgentCapsA-Funktion (tapi.h)

Artikel
11/20/2024

Die lineGetAgentCaps-Funktion ruft die agentbezogenen Funktionen ab, die auf dem angegebenen Liniengerät unterstützt werden. Wenn ein bestimmter Agent benannt wird, enthalten die Funktionen eine Auflistung von ACD-Gruppen, bei denen sich der Agent anmelden darf.

Syntax

LONG lineGetAgentCapsA(
  HLINEAPP        hLineApp,
  DWORD           dwDeviceID,
  DWORD           dwAddressID,
  DWORD           dwAppAPIVersion,
  LPLINEAGENTCAPS lpAgentCaps
);

Parameter

hLineApp

Behandeln Sie die Registrierung der Anwendung mit TAPI.

dwDeviceID

Zeilengerät, das die adresse enthält, die abgefragt werden soll.

dwAddressID

Adresse auf dem angegebenen Zeilengerät, dessen Funktionen abgefragt werden sollen. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt für Betriebssystemupgrades konstant.

dwAppAPIVersion

Höchste API-Version, die von der Anwendung unterstützt wird. Dies sollte nicht der Wert sein, der mit lineNegotiateAPIVersion auf dem abgefragten Gerät ausgehandelt wird.

lpAgentCaps

Zeiger auf eine variabel angepasste Struktur des Typs LINEAGENTCAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zu Agentfunktionen gefüllt. Vor dem Aufrufen von lineGetAgentCapssollte die Anwendung das dwTotalSize Member dieser Struktur festlegen, um die Menge an Arbeitsspeicher anzugeben, die tapI für die Rückgabe von Informationen verfügbar 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_BADDEVICEID, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALADDRESSID, LINEERR_INVALAPPHANDLE, LINEERR_INVALPOINTER, LINEERR_NODEVICE, LINEERR_NODRIVER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Bemerkungen

Anmerkung

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