TSPI_phoneSelectExtVersion-Funktion (tspi.h)
Die TSPI_phoneSelectExtVersion-Funktion wählt die angegebene Erweiterungsversion für das angegebene Telefongerät aus. Nachfolgende Anforderungen werden gemäß dieser Erweiterungsversion ausgeführt.
Syntax
LONG TSPIAPI TSPI_phoneSelectExtVersion(
HDRVPHONE hdPhone,
DWORD dwExtVersion
);
Parameter
hdPhone
Das Handle für das Telefon, für das eine Erweiterungsversion ausgewählt werden soll.
dwExtVersion
Die auszuwählende Erweiterungsversion. Diese Versionsnummer wird mit TSPI_phoneNegotiateExtVersion ausgehandelt. Die wichtigste WORD-Version ist die Hauptversionsnummer und die am wenigsten signifikante WORD 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:
PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Hinweise
Diese Funktion 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 PHONEERR_INCOMPATIBLEEXTVERSION).
Nachfolgende Vorgänge auf dem Telefon, nachdem eine Erweiterungsversion ausgewählt wurde, verhalten sich entsprechend dieser Erweiterungsversion. Nachfolgende Versuche, den Erweiterungsversionsbericht ausschließlich mit der ausgewählten Version oder 0 zu verhandeln (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, seine gesamte Bandbreite an Erweiterungsversionsnummern zu unterstützen.
TSPI_phoneSelectExtVersion wird in der Regel in zwei Situationen aufgerufen: (1) Eine Anwendung, die zum Öffnen eines Telefons angefordert wurde, die Anwendung verlangte, dass eine bestimmte Erweiterungsversion verwendet wird, und es wurde derzeit keine Erweiterungsversion ausgewählt; oder (2) Die letzte Anwendung, die eine bestimmte Erweiterungsversion verwendet, hat das Telefon geschlossen, und die Auswahl der Erweiterungsversion kann abgebrochen werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |