GetCommProperties-Funktion (winbase.h)

Artikel
03/06/2024

Ruft Informationen zu den Kommunikationseigenschaften für ein angegebenes Kommunikationsgerät ab.

Syntax

BOOL GetCommProperties(
  [in]  HANDLE     hFile,
  [out] LPCOMMPROP lpCommProp
);

Parameter

[in] hFile

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

[out] lpCommProp

Ein Zeiger auf eine COMMPROP-Struktur , in der die Kommunikationseigenschafteninformationen zurückgegeben werden. Diese Informationen können in nachfolgenden Aufrufen der Funktion SetCommState, SetCommTimeouts oder SetupComm verwendet werden, um das Kommunikationsgerät zu konfigurieren.

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

Die GetCommProperties-Funktion gibt Informationen von einem Gerätetreiber zu den Konfigurationseinstellungen zurück, die vom Treiber unterstützt werden.

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 (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll