TSPI_phoneNegotiateExtVersion-Funktion (tspi.h)
Die TSPI_phoneNegotiateExtVersion-Funktion gibt die höchste Erweiterungsversionsnummer zurück, unter der der Dienstanbieter für dieses Gerät betrieben werden kann, angesichts der Bandbreite möglicher Erweiterungsversionen.
Syntax
LONG TSPIAPI TSPI_phoneNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Parameter
dwDeviceID
Gibt das Telefongerät an, für das die Schnittstellenversionsverhandlung ausgeführt werden soll.
dwTSPIVersion
Gibt eine Schnittstellenversionsnummer an, die für dieses Gerät mit TSPI_phoneNegotiateTSPIVersion ausgehandelt wird. Diese Funktion arbeitet gemäß der Schnittstellenspezifikation auf dieser Versionsebene.
dwLowVersion
Die niedrigste Erweiterungsversionsnummer, unter der TAPI oder seine Clientanwendung betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer und die am wenigsten signifikante WORD die Nebenversionsnummer.
dwHighVersion
Die höchste Erweiterungsversionsnummer, unter der TAPI oder seine Clientanwendung betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer und die am wenigsten signifikante WORD die Nebenversionsnummer.
lpdwExtVersion
Ein Zeiger auf ein DWORD. Nach erfolgreicher Rückgabe von dieser Funktion füllt der Dienstanbieter diesen Speicherort mit der höchsten Erweiterungsversionsnummer innerhalb des vom Aufrufer angeforderten Bereichs aus, unter dem der Dienstanbieter arbeiten kann. Die wichtigste WORD-Version ist die Hauptversionsnummer und die am wenigsten signifikante WORD die Nebenversionsnummer. Wenn der angeforderte Bereich den vom Dienstanbieter unterstützten Bereich nicht überschneidet, gibt die Funktion PHONEERR_INCOMPATIBLEEXTVERSION zurück.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Hinweise
Diese Funktion kann vor oder nach dem Öffnen des Geräts durch TAPI aufgerufen werden. Wenn das Gerät derzeit geöffnet ist und eine Erweiterungsversion ausgewählt ist, sollte die Funktion diese Versionsnummer zurückgeben, wenn sie sich innerhalb des angeforderten Bereichs befindet. Wenn sich die ausgewählte Versionsnummer außerhalb des angeforderten Bereichs befindet, gibt die Funktion PHONEERR_INCOMPATIBLEEXTVERSION zurück.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |