TSPI_lineGetExtensionID-Funktion (tspi.h)
Die TSPI_lineGetExtensionID-Funktion gibt den Erweiterungsbezeichner zurück, den der Dienstanbieter für das angegebene Leitungsgerät unterstützt.
Syntax
LONG TSPIAPI TSPI_lineGetExtensionID(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
LPLINEEXTENSIONID lpExtensionID
);
Parameter
dwDeviceID
Das abzufragte Leitungsgerät.
dwTSPIVersion
Eine Schnittstellenversionsnummer, die bereits mit TSPI_lineNegotiateTSPIVersion für dieses Gerät ausgehandelt wurde. Diese Funktion arbeitet gemäß der Schnittstellenspezifikation auf dieser Versionsebene.
lpExtensionID
Ein Zeiger auf eine Struktur vom Typ LINEEXTENSIONID. 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. (Daher kann ein gültiger Erweiterungsbezeichner nicht aus allen Nullen bestehen.)
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.
Hinweise
Diese Funktion wird in der Regel von TAPI als Reaktion auf eine Anwendung aufgerufen, die die funktion lineNegotiateAPIVersion aufruft . Das vom Dienstanbieter zurückgegebene Ergebnis sollte für die Verwendung in einem nachfolgenden Aufruf von TSPI_lineNegotiateExtVersion geeignet sein. Ein Erweiterungsbezeichner aller Nullen ist kein rechtlicher Erweiterungsbezeichner, da der Wert für alle Nullen verwendet wird, um anzugeben, dass der Dienstanbieter keine Erweiterungen unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |