lineSetDevConfigA-Funktion (tapi.h)

Die lineSetDevConfig--Funktion ermöglicht der Anwendung die Wiederherstellung der Konfiguration eines Mediendatenstromgeräts auf einem Leitungsgerät auf einem Setup, das zuvor mithilfe lineGetDevConfigabgerufen wurde. Beispielsweise könnte der Inhalt dieser Struktur Datenrate, Zeichenformat, Modulationsschemas und Fehlersteuerungsprotokolleinstellungen für ein "datamodem"-Mediengerät angeben, das der Zeile zugeordnet ist.

Syntax

LONG lineSetDevConfigA(
  DWORD        dwDeviceID,
  LPVOID const lpDeviceConfig,
  DWORD        dwSize,
  LPCSTR       lpszDeviceClass
);

Parameter

dwDeviceID

Bezeichner des zu konfigurierenden Leitungsgeräts.

lpDeviceConfig

Zeiger auf die undurchsichtige Konfigurationsdatenstruktur, die von lineGetDevConfig- im variablen Teil der VARSTRING--Struktur zurückgegeben wurde.

dwSize

Anzahl der Bytes in der Struktur, auf die durch lpDeviceConfigverwiesen wird. Dieser Wert wird im dwStringSize Member in der VARSTRING- Struktur zurückgegeben, die von lineGetDevConfigzurückgegeben wird.

lpszDeviceClass

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Konfiguration festgelegt werden soll. Gültige Geräteklassenzeichenfolgen sind identisch mit denen, die für die lineGetID--Funktion angegeben wurden.

Rückgabewert

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

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

Bemerkungen

Anrufzustände sind gerätespezifisch.

In der Regel ruft eine Anwendung lineGetID- auf, um das Mediendatenstromgerät zu identifizieren, das einer Zeile zugeordnet ist, und ruft dann lineConfigDialog auf, damit der Benutzer die Gerätekonfiguration einrichten kann. Anschließend kann lineGetDevConfig- aufgerufen und die Konfigurationsinformationen in einem Telefonbuch oder einer anderen Datenbank gespeichert werden, die einem bestimmten Anrufziel zugeordnet ist. Wenn der Benutzer dasselbe Ziel erneut aufrufen möchte, kann diese lineSetDevConfig--Funktion verwendet werden, um die vom Benutzer ausgewählten Konfigurationseinstellungen wiederherzustellen. Die lineSetDevConfig-, lineConfigDialogund lineGetDevConfig Funktionen können verwendet werden, damit der Benutzer die Einstellungen anzeigen und aktualisieren kann.

Das genaue Format der in der Struktur enthaltenen Daten ist spezifisch für die Zeilen- und Mediendatenstrom-API (Geräteklasse), ist nicht dokumentiert und ist nicht definiert. Die Anwendung muss sie als "undurchsichtig" behandeln und den Inhalt nicht direkt bearbeiten. Im Allgemeinen kann die Struktur nur mit dieser Funktion an dasselbe Gerät gesendet werden, von dem sie abgerufen wurde. Bestimmte Telefoniedienstanbieter können jedoch zulassen, dass Strukturen zwischen identischen Geräten ausgetauscht werden (d. a. mehrere Ports auf derselben Multiportmodemkarte). Eine solche Austauschbarkeit ist in keiner Weise gewährleistet, auch für Geräte derselben Geräteklasse.

Einige Dienstanbieter erlauben möglicherweise, dass die Konfiguration festgelegt wird, während ein Anruf aktiv ist, und andere nicht.

Anmerkung

Der header tapi.h definiert lineSetDevConfig als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	tapi.h
Library	Tapi32.lib
DLL-	Tapi32.dll

Siehe auch

Referenz zu grundlegenden Telefoniediensten

TAPI 2.2 Referenzübersicht

VARSTRING-

lineConfigDialog-

lineGetDevConfig-

lineGetID-