phoneNegotiateExtVersion-Funktion (tapi.h)
Mit der phoneNegotiateExtVersion--Funktion kann eine Anwendung eine Erweiterungsversion aushandeln, die mit dem angegebenen Telefongerät verwendet werden soll. 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
Behandeln Sie die Registrierung der Anwendung mit TAPI.
dwDeviceID
Der Bezeichner des telefonbasierten Geräts, das abgefragt werden soll.
dwAPIVersion
API-Versionsnummer, die für das angegebene Telefongerät mit phoneNegotiateAPIVersionausgehandelt wurde.
dwExtLowVersion
Zuletzt verwendete Erweiterungsversion des Erweiterungsbezeichners, der von phoneNegotiateAPIVersion zurückgegeben wird,, mit der die Anwendung kompatibel ist. Das Hochreihenfolgenwort ist die Hauptversionsnummer; Das Wort mit niedriger Reihenfolge ist die Nebenversionsnummer.
dwExtHighVersion
Die neueste Erweiterungsversion des Erweiterungsbezeichners, der von phoneNegotiateAPIVersion zurückgegeben wird, mit der die Anwendung kompatibel ist. Das Hochreihenfolgenwort ist die Hauptversionsnummer; Das Wort mit niedriger Reihenfolge ist die Nebenversionsnummer.
lpdwExtVersion
Zeigen Sie auf einen DWORD-, in dem die ausgehandelte Erweiterungsversionsnummer zurückgegeben wird. Wenn die Aushandlung erfolgreich ist, befindet sich diese Zahl im Bereich dwExtLowVersion bis dwExtHighVersion.
Rückgabewert
Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, 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.
Bemerkungen
Die phoneNegotiateExtVersion-Funktion wird verwendet, um die zu verwendende API-Versionsnummer auszuhandeln. Sie gibt den Vom Telefongerät unterstützten Erweiterungsbezeichner oder Nullen zurück, 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 durch dwDeviceID- angegebene Gerätebezeichner variiert von Null bis 1 kleiner als die Anzahl der vorhandenen Telefongeräte.
Die ausgehandelte Nummer der Erweiterungsversion besteht darin, dass die Anwendung und der Dienstanbieter beide funktionieren müssen. Wenn Versionsbereiche nicht überlappen, sind die Anwendungs- und Dienstanbieterversionen inkompatibel und es wird ein Fehler zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | tapi.h |
| Library | Tapi32.lib |
| DLL- | Tapi32.dll |