CommConfigDialogW-Funktion (winbase.h)
Zeigt ein vom Treiber bereitgestelltes Konfigurationsdialogfeld an.
Syntax
BOOL CommConfigDialogW(
[in] LPCWSTR 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 hat.
[in, out] lpCC
Ein Zeiger auf eine COMMCONFIG--Struktur. Diese Struktur enthält anfangseinstellungen für das Dialogfeld vor dem Aufruf und geänderte Werte nach dem Aufruf.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Die CommConfigDialog--Funktion erfordert eine DLL (Dynamic Link Library), die vom Anbieter der Kommunikationshardware bereitgestellt wird.
Anmerkung
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 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP |
| mindestens unterstützte Server- | Windows Server 2003 |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |