Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Versucht, ein Kommunikationsgerät zu öffnen.
Syntax
HANDLE OpenCommPort(
[in] ULONG uPortNumber,
[in] DWORD dwDesiredAccess,
[in] DWORD dwFlagsAndAttributes
);
Parameter
[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 |
|---|---|
|
Die Datei oder das Gerät wird für asynchrone E/A-Vorgänge geöffnet oder erstellt. |
Rückgabewert
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.
Hinweise
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.
Anforderungen
| 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 |