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

Weitere Informationen

LINEADDRESSSTATUS