lineGetAddressCapsA-Funktion (tapi.h)

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

Syntax

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

Parameter

hLineApp

Behandeln Sie die Registrierung der Anwendung mit TAPI.

dwDeviceID

Zeilengerät, das die adresse enthält, die abgefragt werden soll.

dwAddressID

Adresse auf dem angegebenen Zeilengerät, dessen Funktionen abgefragt werden sollen. Ein Adressbezeichner ist dauerhaft einer Adresse zugeordnet; der Bezeichner bleibt für Betriebssystemupgrades konstant.

dwAPIVersion

Versionsnummer der zu verwendenden Telefonie-API. Das Hochreihenfolgenwort enthält die Hauptversionsnummer; Das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer. Diese Zahl wird von lineNegotiateAPIVersionabgerufen.

dwExtVersion

Versionsnummer der zu verwendenden Dienstanbietererweiterungen. Diese Zahl kann auf Null festgelegt werden, wenn keine gerätespezifischen Erweiterungen verwendet werden sollen. Andernfalls enthält das Wort "Hochreihenfolge" die Hauptversionsnummer; und das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer.

lpAddressCaps

Zeiger auf eine variabel angepasste Struktur des Typs LINEADDRESSCAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Adressfunktioneninformationen gefüllt. Vor dem Aufrufen von lineGetAddressCapssollte die Anwendung die dwTotalSize Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher für TAPI für die Rückgabe von Informationen verfügbar ist.

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

 

Rückgabewert

Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, 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_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_NODEVICE.

Bemerkungen

Gültige Adressbezeichner reichen von Null bis 1 kleiner als die Anzahl der Adressen, die von lineGetDevCapszurückgegeben werden. Die versionsnummer, die angegeben werden soll, ist die Versionsnummer, die als Teil der Gerätefunktionen der Zeile von lineGetDevCapszurückgegeben wurde.

Anmerkung

Der header tapi.h definiert lineGetAddressCaps als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	tapi.h
Library	Tapi32.lib
DLL-	Tapi32.dll

Siehe auch

Referenz zu grundlegenden Telefoniediensten

LINEADDRESSCAPS-

TAPI 2.2 Referenzübersicht

lineGetDevCaps-

lineNegotiateAPIVersion