lineGetAddressCaps-Funktion (tapi.h)

Artikel
08/26/2023

Die lineGetAddressCaps-Funktion fragt die angegebene Adresse auf dem angegebenen Leitungsgerät ab, um dessen Telefoniefunktionen zu ermitteln.

Syntax

LONG lineGetAddressCaps(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Parameter

hLineApp

Verarbeiten sie die Registrierung der Anwendung bei TAPI.

dwDeviceID

Leitungsgerät, das die abzufragende Adresse enthält.

dwAddressID

Adresse auf dem angegebenen Leitungsgerät, dessen Funktionen abgefragt werden sollen. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

dwAPIVersion

Versionsnummer der zu verwendenden Telefonie-API. Das Wort mit hoher Ordnung enthält die Hauptversionsnummer; das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer. Diese Nummer wird von lineNegotiateAPIVersion abgerufen.

dwExtVersion

Versionsnummer der zu verwendenden Dienstanbieter-spezifischen Erweiterungen. Diese Zahl kann auf null festgelegt werden, wenn keine gerätespezifischen Erweiterungen verwendet werden sollen. Andernfalls enthält das Wort mit hoher Ordnung die Hauptversionsnummer. und das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer.

lpAddressCaps

Zeiger auf eine strukturvariable Größe vom Typ LINEADDRESSCAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zu Den Adressfunktionen gefüllt. Vor dem Aufrufen von lineGetAddressCaps sollte die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben von Informationen zur Verfügung steht.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema speicherbelegung .

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONFAILED, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALAPPHANDLE, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_NODEVICE.

Hinweise

Gültige Adressbezeichner reichen von null bis eins kleiner als die Anzahl der adressen, die von lineGetDevCaps zurückgegeben werden. Die bereitzustellende Versionsnummer ist die Versionsnummer, die als Teil der Gerätefunktionen der Zeile von lineGetDevCaps zurückgegeben wurde.