TSPI_lineNegotiateTSPIVersion-Funktion (tspi.h)
Die TSPI_lineNegotiateTSPIVersion-Funktion gibt die höchste SPI-Version zurück, unter der der Dienstanbieter für dieses Gerät arbeiten kann, da der Bereich der möglichen SPI-Versionen vorhanden ist.
Syntax
LONG TSPIAPI TSPI_lineNegotiateTSPIVersion(
DWORD dwDeviceID,
DWORD dwLowVersion,
DWORD dwHighVersion,
LPDWORD lpdwTSPIVersion
);
Parameter
dwDeviceID
Gibt das Leitungsgerät an, für das die Schnittstellenversionsverhandlung ausgeführt werden soll. Zusätzlich zu den Gerätebezeichnern innerhalb des bereichs, den der Dienstanbieter unterstützt, kann dies der Wert sein:
INITIALIZE_NEGOTIATION
Dieser Wert wird verwendet, um anzugeben, dass eine Allgemeine Schnittstellenversion ausgehandelt werden soll.
dwLowVersion
Die niedrigste TSPI-Versionsnummer, unter der TAPI betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer.
dwHighVersion
Die höchste TSPI-Versionsnummer, unter der TAPI betrieben werden kann. Die wichtigste WORD-Version ist die Hauptversionsnummer, und das am wenigsten signifikante WORD ist die Nebenversionsnummer.
lpdwTSPIVersion
Ein Zeiger auf ein DWORD. Der Dienstanbieter füllt diesen Speicherort mit der höchsten TSPI-Versionsnummer 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 sich der angeforderte Bereich nicht mit dem vom Dienstanbieter unterstützten Bereich überschneidet, gibt die Funktion LINEERR_INCOMPATIBLEAPIVERSION 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_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Wenn dwDeviceIDINITIALIZE_NEGOTIATION ist, darf diese Funktion keine LINEERR_OPERATIONUNAVAIL zurückgeben, da diese Funktion (mit diesem Wert) für die Verhandlung der gesamten Schnittstellenversion obligatorisch ist, auch wenn der Dienstanbieter keine Leitungsgeräte unterstützt.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform | Windows |
Kopfzeile | tspi.h |