lineAgentSpecific-Funktion (tapi.h)

Artikel
03/02/2024

Die lineAgentSpecific-Funktion ermöglicht der Anwendung den Zugriff auf proprietäre handlerspezifische Funktionen des Agenthandlers, der der Adresse zugeordnet ist. Die Bedeutung der Erweiterungen ist spezifisch für den Agent-Handler. Jeder Satz von Agent-bezogenen Erweiterungen wird durch eine universell eindeutige 128-Bit-Erweiterungs-ID identifiziert, die zusammen mit der Spezifikation für die Erweiterung vom Promulgator dieser Erweiterung abgerufen werden muss (in der Regel der Autor der Agenthandlersoftware auf dem Telefonieserver). Die Liste der vom Agenthandler unterstützten Erweiterungen wird aus der LINEAGENTCAPS-Struktur abgerufen, die von lineGetAgentCaps zurückgegeben wird.

Syntax

LONG lineAgentSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  DWORD  dwAgentExtensionIDIndex,
  LPVOID lpParams,
  DWORD  dwSize
);

Parameter

hLine

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

dwAddressID

Adresse auf dem Offenzeilengerät. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

dwAgentExtensionIDIndex

Position in der ExtensionIDList-Struktur in LINEAGENTCAPS der aufgerufenen Agent-Handlererweiterung.

lpParams

Zeiger auf einen Speicherbereich, der zum Speichern eines Parameterblocks verwendet wird. Das Format dieses Parameterblocks ist gerätespezifisch, und sein Inhalt wird von TAPI an und von der Agenthandleranwendung auf dem Telefonieserver übergeben. Dieser Parameterblock muss die aufzurufende Funktion angeben und ausreichend Platz für die Rückgabe von Daten enthalten.

dwSize

Größe des Parameterblockbereichs in Bytes.

Hinweis Wenn lpParams ein Zeiger auf eine Zeichenfolge ist, muss die Größe den NULL-Abschlusszeichen enthalten.

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_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_STRUCTURETOOSMALL, LINEERR_UNINITIALIZED.

Zusätzliche Rückgabewerte sind spezifisch für den Agent-Handler.

Hinweise

Dieser Vorgang ist Teil der erweiterten Telefoniedienste. Sie bietet Zugriff auf ein agenthandlerspezifisches Feature, ohne dessen Bedeutung zu definieren.

Diese Funktion stellt ein generisches Parameterprofil bereit. Die Interpretation der Parameterstruktur ist handlerspezifisch. Hinweise und Antworten, die an die Anwendung zurückgesendet werden, die handlerspezifisch sind, sollten die LINE_AGENTSPECIFIC Meldung verwenden.

Ein Agent-Handler kann zugriff auf handlerspezifische Funktionen bereitstellen, indem Parameter für die Verwendung mit dieser Funktion definiert werden. Anwendungen, die diese Erweiterungen verwenden möchten, sollten die herstellerspezifische Dokumentation lesen, in der beschrieben wird, welche Erweiterungen definiert sind. In der Regel kann eine Anwendung, die auf diesen Erweiterungen basiert, nicht mit anderen Agenthandlerumgebungen arbeiten.