GetDefaultCommConfigW-Funktion (winbase.h)
Ruft die Standardkonfiguration für das angegebene Kommunikationsgerät ab.
Syntax
BOOL GetDefaultCommConfigW(
[in] LPCWSTR 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, der die Größe des Puffers angibt, auf den durch lpCC-in Bytes verwiesen wird. Bei Rückgabe enthält die Variable die Anzahl der kopierten Bytes, wenn die Funktion erfolgreich ist, oder die Anzahl der Bytes, die erforderlich sind, wenn der Puffer zu klein war.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Verwenden Sie zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion.
Bemerkungen
Anmerkung
Der winbase.h-Header definiert GetDefaultCommConfig als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |