GetDefaultCommConfigA-Funktion (winbase.h)
Ruft die Standardkonfiguration für das angegebene Kommunikationsgerät ab.
Syntax
BOOL GetDefaultCommConfigA(
[in] LPCSTR lpszName,
[out] LPCOMMCONFIG lpCC,
[in, out] LPDWORD lpdwSize
);
Parameter
[in] lpszName
Der Name des Geräts. Com1 bis COM9 sind beispielsweise serielle Ports und LPT1 bis LPT9 sind parallele Ports.
[out] lpCC
Ein Zeiger auf einen Puffer, der eine COMMCONFIG-Struktur empfängt.
[in, out] lpdwSize
Ein Zeiger auf eine Variable, die die Größe des Puffers angibt, auf den lpCC in Bytes verweist. Bei der Rückgabe enthält die Variable die Anzahl der Bytes, die kopiert werden, wenn die Funktion erfolgreich ist, oder die Anzahl der erforderlichen Bytes, wenn der Puffer zu klein war.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.
Hinweise
Hinweis
Der winbase.h-Header definiert GetDefaultCommConfig 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP |
| Unterstützte Mindestversion (Server) | Windows Server 2003 |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (Windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |