phoneNegotiateExtVersion-Funktion (tapi.h)

Artikel
03/13/2024

Mit der phoneNegotiateExtVersion-Funktion kann eine Anwendung eine Erweiterungsversion für die Verwendung mit dem angegebenen Telefongerät aushandeln. Dieser Vorgang muss nicht aufgerufen werden, wenn die Anwendung keine Erweiterungen unterstützt.

Syntax

LONG phoneNegotiateExtVersion(
  HPHONEAPP hPhoneApp,
  DWORD     dwDeviceID,
  DWORD     dwAPIVersion,
  DWORD     dwExtLowVersion,
  DWORD     dwExtHighVersion,
  LPDWORD   lpdwExtVersion
);

Parameter

hPhoneApp

Verarbeiten sie die Registrierung der Anwendung bei TAPI.

dwDeviceID

Bezeichner des abzufragten Telefongeräts.

dwAPIVersion

API-Versionsnummer, die für das angegebene Telefongerät mit phoneNegotiateAPIVersion ausgehandelt wurde.

dwExtLowVersion

Die neueste Erweiterungsversion des Von phoneNegotiateAPIVersion zurückgegebenen Erweiterungsbezeichners, mit dem die Anwendung kompatibel ist. Das Wort mit hoher Ordnung ist die Hauptversionsnummer; Das Wort mit niedriger Ordnung ist die Nebenversionsnummer.

dwExtHighVersion

Die neueste Erweiterungsversion des Erweiterungsbezeichners, der von phoneNegotiateAPIVersion zurückgegeben wurde, mit der die Anwendung kompatibel ist. Das Wort mit hoher Ordnung ist die Hauptversionsnummer; Das Wort mit niedriger Ordnung ist die Nebenversionsnummer.

lpdwExtVersion

Zeiger auf ein DWORD , in dem die ausgehandelte Versionsnummer der Erweiterung zurückgegeben wird. Wenn die Aushandlung erfolgreich ist, liegt diese Zahl im Bereich dwExtLowVersion bis 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:

PHONEERR_INVALAPPHANDLE, PHONEERR_OPERATIONFAILED, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NODRIVER, PHONEERR_NOMEM, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_UNINITIALIZED, PHONEERR_INVALPOINTER, PHONEERR_NODEVICE.

Hinweise

Die phoneNegotiateExtVersion-Funktion wird verwendet, um die zu verwendende API-Versionsnummer auszuhandeln. Er gibt den vom Telefongerät unterstützten Erweiterungsbezeichner zurück, oder null, wenn keine Erweiterungen bereitgestellt werden.

Damit die Anwendung die durch den zurückgegebenen Erweiterungsbezeichner definierten Erweiterungen verwenden kann, muss sie phoneNegotiateExtVersion aufrufen, um die zu verwendende Erweiterungsversion auszuhandeln.

Verwenden Sie phoneInitializeEx , um die Anzahl der im System vorhandenen Telefongeräte zu ermitteln. Der von dwDeviceID angegebene Gerätebezeichner variiert von null bis 1 kleiner als die Anzahl der vorhandenen Telefongeräte.

Die ausgehandelte Versionsnummer der Erweiterung ist die Nummer, unter der die Anwendung und der Dienstanbieter beide arbeiten müssen. Wenn sich die Versionsbereiche nicht überschneiden, sind die Anwendungs- und Dienstanbieterversionen inkompatibel, und es wird ein Fehler zurückgegeben.