phoneNegotiateAPIVersion-Funktion (tapi.h)

Artikel
03/02/2024

Mit phoneNegotiateAPIVersion kann eine Anwendung eine API-Version aushandeln, die für das angegebene Telefongerät verwendet werden soll.

Syntax

LONG phoneNegotiateAPIVersion(
  HPHONEAPP          hPhoneApp,
  DWORD              dwDeviceID,
  DWORD              dwAPILowVersion,
  DWORD              dwAPIHighVersion,
  LPDWORD            lpdwAPIVersion,
  LPPHONEEXTENSIONID lpExtensionID
);

Parameter

hPhoneApp

Behandeln Sie die Registrierung der Anwendung bei TAPI.

dwDeviceID

Bezeichner des abzufragten Telefongeräts.

dwAPILowVersion

Die neueste API-Version, mit der die Anwendung kompatibel ist. Das Wort mit hoher Ordnung ist die Hauptversionsnummer, das Wort mit niedriger Reihenfolge die Nebenversionsnummer.

dwAPIHighVersion

Die neueste API-Version, mit der die Anwendung kompatibel ist. Das Wort mit hoher Ordnung ist die Hauptversionsnummer, das Wort mit niedriger Reihenfolge die Nebenversionsnummer.

lpdwAPIVersion

Zeiger auf ein DWORD , in dem die ausgehandelte API-Versionsnummer zurückgegeben wird. Wenn die Aushandlung erfolgreich ist, liegt diese Zahl im Bereich dwAPILowVersion bis dwAPIHighVersion.

lpExtensionID

Zeiger auf eine Struktur vom Typ PHONEEXTENSIONID. Wenn der Dienstanbieter für den angegebenen dwDeviceID-Parameter anbieterspezifische Erweiterungen unterstützt, wird diese Struktur mit dem Erweiterungsbezeichner dieser Erweiterungen gefüllt, wenn die Aushandlung erfolgreich ist. Diese Struktur enthält alle Nullen, wenn die Zeile keine Erweiterungen enthält. Eine Anwendung kann den zurückgegebenen Parameter ignorieren, wenn sie keine Erweiterungen verwendet.

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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Hinweise

Die funktion phoneNegotiateAPIVersion wird verwendet, um die API-Versionsnummer auszuhandeln, die mit dem angegebenen Telefongerät verwendet werden soll. Es gibt den vom Telefongerät unterstützten Erweiterungsbezeichner oder Nullen zurück, wenn keine Erweiterungen bereitgestellt werden.

Wenn die Anwendung die durch den zurückgegebenen Erweiterungsbezeichner definierten Erweiterungen verwenden möchte, muss sie phoneNegotiateExtVersion anrufen, 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 zwischen null und eins kleiner als die Anzahl der vorhandenen Telefongeräte.

Die ausgehandelte API-Versionsnummer ist die, unter der TAPI betrieben werden kann. Wenn sich Versionsbereiche nicht überlappen, sind die Versionen der Anwendung, API oder des Dienstanbieters inkompatibel, und es wird ein Fehler zurückgegeben.