TSPI_phoneGetExtensionID-Funktion (tspi.h)
Die TSPI_phoneGetExtensionID-Funktion ruft den Erweiterungsbezeichner ab, den der Dienstanbieter für das angegebene Telefongerät unterstützt.
Syntax
LONG TSPIAPI TSPI_phoneGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPPHONEEXTENSIONID lpExtensionID
);
Parameter
dwDeviceID
Das abzufragte Telefongerät.
dwTSPIVersion
Gibt eine Schnittstellenversionsnummer an, die für dieses Gerät mit TSPI_phoneNegotiateTSPIVersion ausgehandelt wird. Diese Funktion arbeitet gemäß der Schnittstellenspezifikation auf dieser Versionsebene.
lpExtensionID
Ein Zeiger auf eine Struktur vom Typ PHONEEXTENSIONID. Wenn der Dienstanbieter anbieterspezifische Erweiterungen unterstützt, füllt er diese Struktur mit dem Erweiterungsbezeichner dieser Erweiterungen aus. Wenn der Dienstanbieter keine Erweiterungen unterstützt, füllt er diese Struktur mit allen Nullen aus. Ein Erweiterungsbezeichner aller Nullen ist kein rechtlicher Erweiterungsbezeichner, da der Wert "Alle Nullen" verwendet wird, um anzugeben, dass der Dienstanbieter keine Erweiterungen unterstützt.
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_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.
Hinweise
Diese Funktion wird in der Regel von TAPI als Reaktion auf eine Anwendung aufgerufen, die die Funktion phoneNegotiateAPIVersion aufruft . Das vom Dienstanbieter zurückgegebene Ergebnis sollte für die Verwendung in einem nachfolgenden Aufruf von TSPI_phoneNegotiateExtVersion geeignet sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |