lineGetAgentCapsA-Funktion (tapi.h)

Artikel
08/26/2023

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

Syntax

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

Parameter

hLineApp

Verarbeiten sie die Registrierung der Anwendung bei TAPI.

dwDeviceID

Leitungsgerät, das die abzufragende Adresse enthält.

dwAddressID

Adresse auf dem angegebenen Leitungsgerät, dessen Funktionen abgefragt werden sollen. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg 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 strukturvariable Größe vom Typ LINEAGENTCAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zu Agentfunktionen gefüllt. Vor dem Aufrufen von lineGetAgentCaps sollte die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben von Informationen zur Verfügung steht.

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.

Hinweise

Hinweis

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