lineConfigDialog-Funktion (tapi.h)

Artikel
03/06/2024

Die lineConfigDialog-Funktion bewirkt, dass der Anbieter des angegebenen Zeilengeräts ein Dialogfeld anzeigt (das an hwndOwner der Anwendung angefügt ist), damit der Benutzer Parameter im Zusammenhang mit dem Leitungsgerät konfigurieren kann.

Syntax

LONG lineConfigDialog(
  DWORD  dwDeviceID,
  HWND   hwndOwner,
  LPCSTR lpszDeviceClass
);

Parameter

dwDeviceID

Bezeichner des zu konfigurierenden Leitungsgeräts.

hwndOwner

Handle für ein Fenster, an das das Dialogfeld angefügt werden soll. Kann NULL sein, um anzugeben, dass jedes während der Funktion erstellte Fenster kein Besitzerfenster haben sollte.

lpszDeviceClass

Zeiger auf eine NULL-endende Zeichenfolge, die einen Geräteklassennamen identifiziert. Mit dieser Geräteklasse kann die Anwendung einen bestimmten Unterbildschirm der Konfigurationsinformationen auswählen, die für diese Geräteklasse gelten. Dieser Parameter ist optional und kann NULL oder leer bleiben. In diesem Fall wird die Konfiguration der höchsten Ebene ausgewählt.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_OPERATIONFAILED, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPARAM, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODEVICE.

Hinweise

Die lineConfigDialog-Funktion bewirkt, dass der Dienstanbieter ein modales Dialogfeld anzeigt (das an hwndOwner der Anwendung angefügt ist), damit der Benutzer Parameter konfigurieren kann, die sich auf die durch dwDeviceID angegebene Zeile beziehen. 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 denen für lineGetID. Wenn die Zeile z. B. die Comm-API unterstützt, bewirkt die Übergabe von "COMM" als lpszDeviceClass , dass der Anbieter die Speziell für Comm relevanten Parameter anzeigt (oder zumindest am entsprechenden Punkt in einer Konfigurationsdialogfeldkette mit mehreren Ebenen beginnt, sodass der Benutzer nicht "graben" muss, um die relevanten Parameter zu finden).

Der parameter lpszDeviceClass wäre "tapi/line", "" oder NULL , damit der Anbieter die Konfiguration der höchsten Ebene für die Zeile anzeigt.