TUISPI_providerInstall-Funktion (tspi.h)

Artikel
08/26/2023

Die Implementierung der TUISPI_providerInstall-Funktion ist die Möglichkeit des Dienstanbieters, zusätzliche "Teile" des Anbieters in den richtigen Verzeichnissen zu installieren (oder zumindest zu überprüfen, ob sie vorhanden sind) und Registrierungseinträge einzurichten, die der Anbieter benötigt. Diese Funktion macht die funktion TSPI_providerInstall in Version 2.0 und höher veraltet (unterstützt in Version 1.4 und früher).

Wenn der Dienstanbieter für den ordnungsgemäßen Betrieb privat definierte Einträge in der Registrierung benötigt, müssen diese zu diesem Zeitpunkt installiert werden.

Die Implementierung ist optional.

Syntax

LONG TSPIAPI TUISPI_providerInstall(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  HWND              hwndOwner,
  DWORD             dwPermanentProviderID
);

Parameter

lpfnUIDLLCallback

Zeiger auf eine Funktion, die die UI-DLL aufrufen kann, um mit der Dienstanbieter-DLL zu kommunizieren, um informationen abzurufen, die zum Anzeigen des Dialogfelds erforderlich sind.

hwndOwner

Das Handle des übergeordneten Fensters, in dem die Funktion alle Dialogfeldfenster erstellen kann, die während der Installation erforderlich sind.

dwPermanentProviderID

Der permanente Anbieterbezeichner des Dienstanbieters.

Rückgabewert

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

LINEERR_OPERATIONFAILED, LINEERR_INIFILECORRUPT, LINEERR_NOMEM. LINEERR_INVALPARAM.

Hinweise

Diese Funktion muss das System in einem konsistenten Zustand belassen. Es sollte bis zum Abschluss ausgeführt werden, sodass der Benutzer die Installation nicht abbrechen kann, wenn sie teilweise abgeschlossen ist. Wenn die Installation fehlschlägt, liegt es in der Verantwortung des Anbieters, den Vorgang "zurückzugeben" und einen Fehler zurückzugeben. Dies kann eine Vorabüberprüfung bedeuten, um zu überprüfen, ob eine vollständige Installation möglich ist, bevor die Installation beginnt.

Diese Funktion kann während der Installation des Dienstanbieters mehrmals aufgerufen werden, bis ein Aufruf von TUISPI_providerRemove erfolgt. Wenn der Dienstanbieter jedoch nicht mehrere Instanzen des Anbieters benötigt oder unterstützt, gibt er die LINEERR_ konstante LINEERR_NOMULTIPLEINSTANCE zurück.

Die entsprechende Funktion auf TAPI-Ebene ist lineAddProvider. Die LINE_CREATE Meldung informiert Anwendungen, die ausgeführt werden, über die dynamische Neukonfiguration.