GetCommConfig-Funktion (winbase.h)

  • Artikel

Ruft die aktuelle Konfiguration eines Kommunikationsgeräts ab.

Verwenden Sie die GetDefaultCommConfig-Funktion , um die Standardkonfigurationseinstellungen aus dem Geräte-Manager abzurufen.

Syntax

BOOL GetCommConfig(
  [in]      HANDLE       hCommDev,
  [out]     LPCOMMCONFIG lpCC,
  [in, out] LPDWORD      lpdwSize
);

Parameter

[in] hCommDev

Ein Handle für das offene Kommunikationsgerät. Die CreateFile-Funktion gibt dieses Handle zurück.

[out] lpCC

Ein Zeiger auf einen Puffer, der eine COMMCONFIG-Struktur empfängt.

[in, out] lpdwSize

Die Größe des Puffers in Bytes, auf den lpCC verweist. Wenn die Funktion zurückgibt, enthält die Variable die Anzahl der Bytes, die kopiert werden, 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 fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winbase.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

COMMCONFIG

Kommunikationsfunktionen

Kommunikationsressourcen

CreateFile

GetDefaultCommConfig

SetCommConfig