GetDefaultCommConfigA-Funktion (winbase.h)

  • Artikel

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

Siehe auch

COMMCONFIG

Kommunikationsfunktionen

Kommunikationsressourcen

SetDefaultCommConfig