Freigeben über


GetCommProperties-Funktion (winbase.h)

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

Siehe auch

COMMPROP

Kommunikationsfunktionen

Kommunikationsressourcen

CreateFile

SetCommState

SetCommTimeouts

SetupComm