TSPI_providerConfig-Funktion (tspi.h)

Die TSPI_providerConfig-Funktion ist veraltet. TAPI Version 1.4 oder früher können diese TSPI-Funktion implementieren. TAPI Version 2.0 oder höher implementieren TUISPI_PROVIDERCONFIG.

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

Syntax

LONG TSPIAPI TSPI_providerConfig(
  HWND  hwndOwner,
  DWORD dwPermanentProviderID
);

Parameter

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 wie folgt:

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.

Das Hilfsprogramm Telefonie Systemsteuerung, das mit Windows-Telefonie in Versionen 1.4 und früher bereitgestellt wird, ruft diese Funktion auf, wenn der Setupbefehl aufgerufen 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.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tspi.h

Weitere Informationen

TSPI_lineConfigDialog

TSPI_phoneConfigDialog

TSPI_providerInstall

TSPI_providerRemove

TUISPI_providerConfig