TSPI_providerInstall-Funktion (tspi.h)

Artikel
03/03/2024

Die funktion TSPI_providerInstall ist veraltet. TAPI Version 1.4 oder frühere Dienstanbieter können diese TSPI-Funktion implementieren. TAPI Version 2.0 oder höher implementieren TSPs TUISPI_providerInstall.

Die TSPI_providerInstall-Funktion installiert alle zusätzlichen "Teile" des Anbieters in den richtigen Verzeichnissen (oder überprüft zumindest, ob sie vorhanden sind), richtet die Registrierungseinträge des Anbieters für seine Leitungen und Telefone ein und erstellt alle anderen Einträge, die für den Dienstanbieter erforderlich sind. Sie wird vom Telefonie-Systemsteuerung-Hilfsprogramm aufgerufen (in Windows-Telefonie in Versionen 1.4 und früher), wenn die Schaltfläche Hinzufügen gedrückt wird.

Syntax

LONG TSPIAPI TSPI_providerInstall(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Parameter

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 schließt die Installation anderer Teile ab, die vom Dienstanbieter nach den Einträgen im Abschnitt [Anbieter] in der Registrierung erforderlich sind. Wenn der Dienstanbieter für den ordnungsgemäßen Betrieb zusätzliche privat definierte Einträge in der Registrierung benötigt, müssen diese ebenfalls installiert werden. Eine typische Möglichkeit, diesen Abschnitt mit seinen Einträgen zu installieren, besteht darin , TSPI_providerConfig aufzurufen.

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 wird während der Installation des Dienstanbieters nur einmal aufgerufen, bis ein Aufruf von TSPI_providerRemove erfolgt. Sie muss vor jeder anderen TSPI-definierten Funktion aufgerufen werden.

Das Telefonie-Systemsteuerung-Hilfsprogramm, das mit Windows-Telefonie in Version 1.4 und früher bereitgestellt wird, ruft diese Funktion auf (wobei die anforderungen an externe Sequenzen erfüllt sind, wie hier beschrieben), wenn der Befehl "add" aufgerufen wird. Für den Befehl "add " wird TSPI_providerConfig nicht aufgerufen.

Es gibt keine entsprechende Funktion auf TAPI-Ebene. Auf dieser Ebene erwarten Anwendungen, dass Dienstanbieter bereits installiert sind. Ausgeführte Anwendungen werden über die dynamische Neukonfiguration über den LINEDEVSTATE_REINIT- oder PHONESTATE_REINIT-Wert in der LINE_LINEDEVSTATE- oder PHONE_STATE-Nachricht informiert.