lineNegotiateExtVersion-Funktion (tapi.h)

Artikel
03/04/2024

Die lineNegotiateExtVersion-Funktion ermöglicht es einer Anwendung, eine Erweiterungsversion auszuhandeln, die mit dem angegebenen Zeilengerät verwendet werden kann. Dieser Vorgang muss nicht aufgerufen werden, wenn die Anwendung keine Erweiterungen unterstützt.

Syntax

LONG lineNegotiateExtVersion(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  DWORD    dwExtLowVersion,
  DWORD    dwExtHighVersion,
  LPDWORD  lpdwExtVersion
);

Parameter

hLineApp

Behandeln Sie die Registrierung der Anwendung bei TAPI.

dwDeviceID

Bezeichner des abzufragten Leitungsgeräts.

dwAPIVersion

TAPI-Versionsnummer, die für das angegebene Zeilengerät mit lineNegotiateAPIVersion ausgehandelt wurde.

dwExtLowVersion

Früheste Erweiterungsversion des Erweiterungsbezeichners, die von lineNegotiateAPIVersion zurückgegeben wird, mit der die Anwendung kompatibel ist. Das Wort "Hohe Ordnung" ist die Hauptversionsnummer. das Wort mit niedriger Ordnung ist die Nebenversionsnummer.

dwExtHighVersion

Neueste Erweiterungsversion des von lineNegotiateAPIVersion zurückgegebenen Erweiterungsbezeichners, mit dem die Anwendung kompatibel ist. Das Wort "Hohe Ordnung" ist die Hauptversionsnummer. das Wort mit niedriger Ordnung ist die Nebenversionsnummer.

lpdwExtVersion

Zeiger auf eine Variable, die die versionsnummer der Erweiterung enthält, die ausgehandelt wurde. Wenn die Aushandlung erfolgreich ist, liegt diese Zahl im Bereich zwischen dwExtLowVersion und dwExtHighVersion.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NODEVICE, LINEERR_OPERATIONUNAVAIL.

Hinweise

Verwenden Sie lineInitializeEx , um die Anzahl der im System vorhandenen Leitungsgeräte zu ermitteln. Der durch dwDeviceID angegebene Gerätebezeichner variiert von null bis eins kleiner als die Anzahl der vorhandenen Leitungsgeräte.

Die lineNegotiateAPIVersion-Funktion verhandelt die zu verwendende API-Versionsnummer. Außerdem wird der vom Zeilengerät unterstützte Erweiterungsbezeichner abgerufen, der null ist, wenn keine Erweiterungen bereitgestellt werden. Versionsnummern sollten für jede Version um eine erhöht werden. Es kann zu unerwarteten Ergebnissen führen, wenn Lücken bei der Nummerierung der Releaseversion bestehen.

Wenn die Anwendung die durch den zurückgegebenen Erweiterungsbezeichner definierten Erweiterungen verwenden möchte, muss sie lineNegotiateExtVersion aufrufen, um die zu verwendende Erweiterungsversion auszuhandeln.

Die ausgehandelte Versionsnummer der Erweiterung ist die Nummer, unter der die Anwendung und der Dienstanbieter arbeiten müssen. Wenn sich Versionsbereiche nicht überlappen, sind die Versionen der Anwendung und des Dienstanbieters inkompatibel, und es wird ein Fehler zurückgegeben.