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 |