CommConfigDialogA-Funktion (winbase.h)

Zeigt ein vom Treiber bereitgestelltes Konfigurationsdialogfeld an.

Syntax

BOOL CommConfigDialogA(
  [in]      LPCSTR       lpszName,
  [in]      HWND         hWnd,
  [in, out] LPCOMMCONFIG lpCC
);

Parameter

[in] lpszName

Der Name des Geräts, für das ein Dialogfeld angezeigt werden soll. COM1 bis COM9 sind beispielsweise serielle Ports und LPT1 bis LPT9 sind parallele Ports.

[in] hWnd

Ein Handle für das Fenster, das das Dialogfeld besitzt. Dieser Parameter kann ein beliebiges gültiges Fensterhandle sein, oder er sollte NULL sein, wenn das Dialogfeld keinen Besitzer haben soll.

[in, out] lpCC

Ein Zeiger auf eine COMMCONFIG-Struktur . Diese Struktur enthält erste Einstellungen für das Dialogfeld vor dem Aufruf und hat die Werte nach dem Aufruf geändert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die CommConfigDialog-Funktion erfordert eine DLL (Dynamic Link Library), die vom Anbieter der Kommunikationshardware bereitgestellt wird.

Hinweis

Der winbase.h-Header definiert CommConfigDialog 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows XP
Unterstützte Mindestversion (Server)	Windows Server 2003
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

COMMCONFIG

Kommunikationsfunktionen

Kommunikationsressourcen