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

Weitere Informationen

INITIALIZE_NEGOTIATION

TSPI-Versionsverwaltung

TSPI_lineGetExtensionID

TSPI_lineNegotiateExtVersion

TSPI_providerInit