TSPI_phoneConfigDialog-Funktion (tspi.h)
Die TSPI_phoneConfigDialog-Funktion ist veraltet. TAPI Version 1.4 oder früher können diese TSPI-Funktion implementieren. TAPI Version 2.0 oder höher implementieren TSPs TUISPI_phoneConfigDialog.
Die TSPI_phoneConfigDialog-Funktion bewirkt, dass der Anbieter des angegebenen Telefongeräts ein modales Dialogfeld als untergeordnetes Fenster von hwndOwner anzeigt, damit der Benutzer Parameter im Zusammenhang mit dem Telefongerät konfigurieren kann.
Syntax
LONG TSPIAPI TSPI_phoneConfigDialog(
DWORD dwDeviceID,
HWND hwndOwner,
LPCSTR lpszDeviceClass
);
Parameter
dwDeviceID
Das zu konfigurierende Telefongerät.
hwndOwner
Ein Handle für ein übergeordnetes Fenster, in dem das Dialogfeldfenster platziert werden soll.
lpszDeviceClass
Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die einen Geräteklassennamen identifiziert. Mit dieser Geräteklasse kann der Aufrufer einen bestimmten Unterbildschirm mit Konfigurationsinformationen auswählen, die für diese Geräteklasse gelten. Wenn dieser Parameter NULL oder eine leere Zeichenfolge ist, wird das Dialogfeld Konfiguration der höchsten Ebene ausgewählt.
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:
PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.
Hinweise
TSPI_phoneConfigDialog bewirkt, dass der Dienstanbieter ein modales Dialogfeld als untergeordnetes Fenster von hWndOwner anzeigt, damit der Benutzer Parameter für das von dwDeviceID angegebene Telefon konfigurieren kann. Mit dem parameter lpszDeviceClass kann die Anwendung einen bestimmten Unterbildschirm der Konfigurationsinformationen auswählen, die für die Geräteklasse gelten, an der der Benutzer interessiert ist. Die zulässigen Zeichenfolgen sind identisch mit TSPI_phoneGetID. Wenn das Telefon beispielsweise die Comm-API unterstützt, bewirkt die Übergabe von comm/datamodem als lpszDeviceClass , dass der Anbieter die Parameter anzeigt, die sich speziell auf Comm beziehen (oder zumindest an dem entsprechenden Punkt in einer Mehrebenenkonfigurationsdialogfeldkette zu starten, sodass der Benutzer nicht suchen muss, um die gewünschten Parameter zu finden). Der szDeviceClass-Parameter sollte "tapi/phone", "" oder NULL lauten, damit der Anbieter die Konfiguration der höchsten Ebene für das Telefon anzeigt.
Die Prozedur muss den Abschnitt [Windows-Telefonie] in der Win.ini-Datei aktualisieren und die WM_WININICHANGE Nachricht senden, wenn änderungen an Telephon.ini vorgenommen werden, die sich auf den Inhalt von Strukturen auswirken, die für Anwendungen (z. B . PHONECAPS) sichtbar sind, oder wenn Telefongeräte erstellt oder entfernt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |