TSPI_lineNegotiateExtVersion-Funktion (tspi.h)
Die TSPI_lineNegotiateExtVersion-Funktion gibt die höchste Versionsnummer der Erweiterung zurück, unter der der Dienstanbieter für dieses Gerät arbeiten kann, wenn der Bereich der möglichen Erweiterungsversionen angegeben ist.
Syntax
LONG TSPIAPI TSPI_lineNegotiateExtVersion(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwExtVersion
);
Parameter
dwDeviceID
Gibt das Leitungsgerät an, für das die Schnittstellenversionsverhandlung ausgeführt werden soll. Der Wert INITIALIZE_NEGOTIATION darf für diese Funktion nicht verwendet werden.
dwTSPIVersion
Eine Schnittstellenversionsnummer, die bereits mit TSPI_lineNegotiateTSPIVersion für dieses Gerät ausgehandelt wurde. Diese Funktion arbeitet gemäß der Schnittstellenspezifikation auf dieser Versionsebene.
dwLowVersion
Die niedrigste Versionsnummer der Erweiterung, unter der TAPI oder seine Clientanwendung betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer. TAPI überprüft diesen Parameter nicht, wenn diese Funktion aufgerufen wird.
dwHighVersion
Die höchste Versionsnummer der Erweiterung, unter der TAPI oder seine Clientanwendung betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer. TAPI überprüft diesen Parameter nicht, wenn diese Funktion aufgerufen wird.
lpdwExtVersion
Ein Zeiger auf ein DWORD. Nach einer erfolgreichen Rückgabe dieser Funktion füllt der Dienstanbieter diesen Speicherort mit der höchsten Versionsnummer der Erweiterung aus, innerhalb des vom Aufrufer angeforderten Bereichs, unter dem der Dienstanbieter arbeiten kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer. Wenn der angeforderte Bereich den vom Dienstanbieter unterstützten Bereich nicht überschneidet, gibt die Funktion LINEERR_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:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_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, gibt die Funktion diese Versionsnummer an, wenn sie innerhalb des angeforderten Bereichs liegt. Wenn die ausgewählte Versionsnummer außerhalb des angeforderten Bereichs liegt, gibt die Funktion LINEERR_INCOMPATIBLEEXTVERSION zurück.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |