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 |