TSPI_lineConfigDialog-Funktion (tspi.h)

Artikel
03/13/2024

Die TSPI_lineConfigDialog 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_lineConfigDialog.

Die TSPI_lineConfigDialog-Funktion bewirkt, dass der Anbieter des angegebenen Zeilengeräts ein modales Dialogfeld als untergeordnetes Fenster von hwndOwner anzeigt, damit der Benutzer Parameter im Zusammenhang mit dem Zeilengerät konfigurieren kann.

Syntax

LONG TSPIAPI TSPI_lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parameter

dwDeviceID

Das zu konfigurierende Leitungsgerä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, sollte das Dialogfeld Konfiguration der höchsten Ebene ausgewählt werden. Die zulässigen Zeichenfolgen sind identisch mit TSPI_lineGetID. Wenn die Zeile beispielsweise die Comm-API unterstützt, führt die Übergabe von comm/datamodem als lpszDeviceClass dazu, dass der Anbieter die speziell mit Comm verbundenen Parameter anzeigt (oder zumindest am entsprechenden Punkt in einer Mehrebenenkonfigurationsdialogfeldkette beginnt, sodass der Benutzer nicht suchen muss, um die gewünschten Parameter zu finden.)

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_INUSE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALDEVICECLASS, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Hinweise

Die Prozedur muss den Abschnitt [Windows-Telefonie] in der Win.ini-Datei aktualisieren und die WM_WININICHANGE-Nachricht senden, wenn änderungen an der Telephon.ini-Datei vorgenommen werden, die eine Änderung der Zeilen- oder Adressfunktionen verursachen würden, die in LINEDEVCAPS oder LINEADDRESSCAPS gemeldet wurden, oder wenn ein Leitungsgerät erstellt oder entfernt wird.

Es gibt keine Einschränkung, dass diese Funktion (TSPI_lineConfigDialog) nur aufgerufen wird, wenn die Zeile geschlossen ist. Allerdings kann jeder Anbieter eine solche Einschränkung selbst erzwingen. Wenn TSPI_lineConfigDialog aufgerufen wird, könnte der Anbieter den Benutzer mit der Meldung "Die Zeile wird von einer oder mehreren Anwendungen verwendet. Sie dürfen die Zeilenkonfiguration nicht ändern, während die Zeile verwendet wird" (und gibt die Fehlermeldung LINEERR_INUSE zurück. Einige Konfigurationen können jedoch "im Handumdrehen" geändert werden, insbesondere solche, die sich auf Medientypen beziehen (z. B. das Modemfehlersteuerungsprotokoll), insbesondere dann, wenn dieser Medientyp derzeit nicht verwendet wird. Der Anbieter kann zulassen, dass diese Optionen geändert werden, während die Zeile geöffnet ist.

Benutzer sollten keine Änderungen vornehmen dürfen, die mit LINEDEVCAPS oder LINEADDRESSCAPS zurückgegebene Werte ändern, ohne die Zeile zuerst gewaltsam zu schließen, als Signal, dass Anwendungen Funktionen aufrufen müssen, die diese Strukturen zurückgeben, um genaue Informationen zu erhalten.