OpenCommPort-Funktion (winbase.h)

Versucht, ein Kommunikationsgerät zu öffnen.

Syntax

HANDLE OpenCommPort(
  [in] ULONG uPortNumber,
  [in] DWORD dwDesiredAccess,
  [in] DWORD dwFlagsAndAttributes
);

[in] uPortNumber

Eine 1-basierte Portnummer für das Zu öffnende Kommunikationsgerät.

[in] dwDesiredAccess

Der angeforderte Zugriff auf das Gerät.

Weitere Informationen zum angeforderten Zugriff finden Sie unter CreateFile und Erstellen und Öffnen von Dateien.

[in] dwFlagsAndAttributes

Die angeforderten Flags und Attribute für das Gerät.

Hinweis

Für diese Funktion werden nur Werte von FILE_FLAG_OVERLAPPED oder 0x0 für diesen Parameter erwartet.

Wert	Bedeutung
FILE_FLAG_OVERLAPPED 0x40000000	Die Datei oder das Gerät wird für asynchrone E/A-Vorgänge geöffnet oder erstellt.

Wenn die Funktion erfolgreich ist, gibt die Funktion einen gültigen HANDLE zurück. Verwenden Sie CloseHandle , um dieses Handle zu schließen.

Wenn ein Fehler auftritt, gibt die Funktion INVALID_HANDLE_VALUE zurück.

Der uPortNumber-Parameter akzeptiert einbasierte Werte. Der Wert 1 für uPortNumber bewirkt, dass diese Funktion versucht, COM1 zu öffnen.

Um UWP zu unterstützen, verknüpfen Sie windowsApp.lib.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1709 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server, Version 1709 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	OneCore.lib
DLL	KernelBase.dll