lineAddProvider-Funktion (tapi.h)

Artikel
03/09/2024

Die lineAddProvider-Funktion installiert einen neuen Telefoniedienstanbieter in das Telefoniesystem.

Syntax

LONG lineAddProvider(
  LPCSTR  lpszProviderFilename,
  HWND    hwndOwner,
  LPDWORD lpdwPermanentProviderID
);

Parameter

lpszProviderFilename

Zeiger auf ein

Null-terminierte Zeichenfolge, die den Pfad des hinzuzufügenden Dienstanbieters enthält.

hwndOwner

Handle an ein Fenster, in dem alle Dialogfelder angefügt werden, die im Rahmen des Installationsvorgangs angezeigt werden müssen (z. B. durch die TSPI_providerInstall-Funktion des Dienstanbieters). Kann NULL sein, um anzugeben, dass jedes während der Funktion erstellte Fenster kein Besitzerfenster haben sollte.

lpdwPermanentProviderID

Zeiger auf eine Variable, die den permanenten Anbieterbezeichner des neu installierten Dienstanbieters empfängt.

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_INIFILECORRUPT, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOMULTIPLEINSTANCE, LINEERR_OPERATIONFAILED.

Hinweise

Während dieses Funktionsaufrufs überprüft TAPI, ob er auf den Dienstanbieter zugreifen kann, indem es seine TSPI_providerInstall-Funktion aufruft. Wenn dies nicht erfolgreich ist (wenn die DLL oder Funktion nicht gefunden werden kann oder wenn TSPI_providerInstall einen Fehler zurückgibt), schlägt die Funktion fehl, und der Anbieter wird nicht zum Telefoniesystem hinzugefügt. Wenn dies erfolgreich ist und das Telefoniesystem aktiv ist (eine oder mehrere Anwendungen haben lineInitialize oder lineInitializeEx aufgerufen), versucht TAPI nicht, den neu hinzugefügten Dienstanbieter zu starten. Um den neuen Dienstanbieter zu aktivieren, gibt TAPI stattdessen eine Meldung aus, um Windows neu zu starten. Wenn die Aktivierung erfolgreich ist, werden Anwendungen über alle neuen Geräte informiert, die mithilfe von LINE_CREATE - oder PHONE_CREATE-Nachrichten erstellt werden, oder durch eine LINE_LINEDEVSTATE Nachricht, die eine Neuinitialisierung anfordert (wenn die Anwendung die CREATE-Nachrichten nicht unterstützt).

Diese Funktion kopiert keine Dateien – weder die Dienstanbieter-DLL selbst noch unterstützende Dateien; Die Anwendung, die das Hinzufügen des Anbieters verwaltet, muss sicherstellen, dass der Anbieter in einem Verzeichnis installiert ist, in dem er von TAPI gefunden werden kann (z. B. \WINDOWS, \WINDOWS\SYSTEM oder an einer anderen Stelle im Pfad).