lineGetProviderList-Funktion (tapi.h)

Die lineGetProviderList-Funktion gibt eine Liste der derzeit im Telefonsystem installierten Dienstanbieter zurück.

Syntax

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

Parameter

dwAPIVersion

Höchste tapi-Version, die von der Anwendung unterstützt wird (nicht unbedingt der wert, der von lineNegotiateAPIVersion auf einem bestimmten Leitungsgerät ausgehandelt wird).

lpProviderList

Zeiger auf einen Speicherort, an dem TAPI eine LINEPROVIDERLIST-Struktur zurückgeben kann. Vor dem Aufruf von lineGetProviderList muss 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_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL.

Anforderungen

   
Zielplattform Windows
Kopfzeile tapi.h
Bibliothek Tapi32.lib
DLL Tapi32.dll

Weitere Informationen

LINEPROVIDERLIST

Ergänzende Zeilendienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz

lineNegotiateAPIVersion