TSPI_lineSelectExtVersion-Funktion (tspi.h)
Die TSPI_lineSelectExtVersion-Funktion wählt die angegebene Erweiterungsversion für das angegebene Leitungsgerät aus. Nachfolgende Anforderungen werden gemäß dieser Erweiterungsversion ausgeführt.
Syntax
LONG TSPIAPI TSPI_lineSelectExtVersion(
HDRVLINE hdLine,
DWORD dwExtVersion
);
Parameter
hdLine
Das Handle für die Zeile, für die eine Erweiterungsversion ausgewählt werden soll.
dwExtVersion
Die auszuwählende Erweiterungsversion. Diese Versionsnummer wurde mit TSPI_lineNegotiateExtVersion ausgehandelt. Die wichtigste WORD ist die Hauptversionsnummer, und die am wenigsten signifikante WORD ist die Nebenversionsnummer. Durch Aufrufen dieser Funktion mit einer dwExtVersion von 0 wird die aktuelle Auswahl abgebrochen.
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:
LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Hinweise
Der Dienstanbieter wählt die angegebene Erweiterungsversion aus. Obwohl die angegebene Versionsnummer möglicherweise erfolgreich ausgehandelt wurde, wurde in der Zwischenzeit möglicherweise eine andere Erweiterungsversion ausgewählt, in diesem Fall schlägt diese Funktion fehl (zurückgeben LINEERR_INCOMPATIBLEEXTVERSION).
Nachfolgende Vorgänge in der Zeile, nachdem eine Erweiterungsversion ausgewählt wurde, verhalten sich entsprechend dieser Erweiterungsversion. Nachfolgende Versuche, den Erweiterungsversionsbericht ausschließlich mit der ausgewählten Version oder 0 auszuhandeln (wenn der angeforderte Bereich die ausgewählte Version nicht enthält). Durch Aufrufen dieser Prozedur mit der speziellen Erweiterung Version 0 wird die aktuelle Auswahl abgebrochen. Das Gerät wird wieder in der Lage, den vollen Bereich der Erweiterungsversionsnummern zu unterstützen.
Diese Funktion verfügt über keine direkte Korrespondenz auf TAPI-Ebene, bei der die Auswahl einer Erweiterungsversion mit der anderen Funktionalität von lineOpen gebündelt wird. Die TSPI_lineSelectExtVersion-Funktion wird in der Regel in zwei Situationen aufgerufen: (1) Eine Anwendung, die zum Öffnen einer Zeile angefordert wurde, die sich daraus ergebende Änderung der Medientypüberwachung war erfolgreich, die Anwendung hat die Verwendung einer bestimmten Erweiterungsversion angefordert, und es wurde derzeit keine Erweiterungsversion ausgewählt. (2) Die letzte Anwendung, die eine bestimmte Erweiterungsversion verwendet, hat die Zeile geschlossen, und die Auswahl der Erweiterungsversion kann abgebrochen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |