TSPI_lineGetAddressStatus-Funktion (tspi.h)
Die TSPI_lineGetAddressStatus-Funktion fragt die angegebene Adresse nach ihrem aktuellen status ab.
Syntax
LONG TSPIAPI TSPI_lineGetAddressStatus(
HDRVLINE hdLine,
DWORD dwAddressID,
LPLINEADDRESSSTATUS lpAddressStatus
);
Parameter
hdLine
Das Handle des Dienstanbieters für die Zeile, die die abzufragende Adresse enthält.
dwAddressID
Eine Adresse auf dem angegebenen Open Line-Gerät. Dies ist die Adresse, die abgefragt werden soll. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet. Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant. Dieser Parameter wird nicht von TAPI überprüft, wenn diese Funktion aufgerufen wird.
lpAddressStatus
Ein Zeiger auf eine datenvariable Größe vom Typ LINEADDRESSSTATUS.
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_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Der Dienstanbieter füllt alle Member der LINEADDRESSSTATUS-Datenstruktur aus, mit Ausnahme von dwTotalSize, das von TAPI ausgefüllt wird. Der Dienstanbieter darf den dwTotalSize-Member nicht überschreiben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |