Share via


SetDefaultCommConfigA-Funktion (winbase.h)

Legt die Standardkonfiguration für ein Kommunikationsgerät fest.

Syntax

BOOL SetDefaultCommConfigA(
  [in] LPCSTR       lpszName,
  [in] LPCOMMCONFIG lpCC,
  [in] DWORD        dwSize
);

Parameter

[in] lpszName

Der Name des Geräts. Com1 bis COM9 sind beispielsweise serielle Ports und LPT1 bis LPT9 sind parallele Ports.

[in] lpCC

Ein Zeiger auf eine COMMCONFIG-Struktur .

[in] dwSize

Die Größe der Struktur, auf die lpCC in Bytes verweist.

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

Hinweis

Der winbase.h-Header definiert SetDefaultCommConfig 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

Siehe auch

COMMCONFIG

Kommunikationsfunktionen

Kommunikationsressourcen

GetDefaultCommConfig