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 |