TUISPI_providerConfig-Funktion (tspi.h)

Artikel
03/06/2024

Die funktion TUISPI_providerConfig implementiert die UI-Elemente, die im Kontext der aufrufenden Anwendung ausgeführt werden müssen. Diese Funktion macht die funktion TSPI_providerConfig in Version 2.0 und höher veraltet (unterstützt in Version 1.4 und früher).

Die TUISPI_providerConfig-Funktion sammelt Konfigurationsinformationen vom Benutzer. Es kann ein Dialogfeld verwenden, und dieses Dialogfeld kann Untergeordnete Dialogfelder enthalten, die anderen APIs (z. B. Comm/datamodem) für die Einrichtung bestimmter Geräte zugeordnet sind.

Die Implementierung ist optional.

Syntax

LONG TSPIAPI TUISPI_providerConfig(
  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 zu erhalten, die zum Anzeigen des Dialogfelds und zum Senden der aktualisierten Konfiguration an den Dienstanbieter erforderlich sind.

hwndOwner

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

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_NOMEM.

Hinweise

Diese Funktion kann aufgerufen werden, während der Dienstanbieter verwendet wird (also zwischen Aufrufen von TSPI_providerInit und TSPI_providerShutdown).

Alle Änderungen, die sich auf das über TSPI sichtbare Verhalten auswirken, sollten nur wirksam werden, wenn der Dienstanbieter beim nächsten TSPI_providerInit neu gestartet wird.

Es gibt keine direkt entsprechende Funktion auf TAPI-Ebene. In TAPI haben Anwendungen Zugriff auf die Funktionen lineConfigDialog und phoneConfigDialog, die die Konfiguration von Parametern einer bestimmten Leitung oder eines bestimmten Telefons nach der Installation ermöglichen.