OpenCommPort, fonction (winbase.h)

Tente d’ouvrir un périphérique de communication.

Syntaxe

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

[in] uPortNumber

Numéro de port de base unique pour l’appareil de communication à ouvrir.

[in] dwDesiredAccess

Accès demandé à l’appareil.

Pour plus d’informations sur l’accès demandé, consultez CreateFile et Creating and Opening Files.

[in] dwFlagsAndAttributes

Indicateurs et attributs demandés à l’appareil.

Remarque

Pour cette fonction, seules les valeurs de FILE_FLAG_OVERLAPPED ou de 0x0 sont attendues pour ce paramètre.

Valeur	Signification
FILE_FLAG_OVERLAPPED 0x40000000	Le fichier ou l’appareil est en cours d’ouverture ou de création pour les E/S asynchrones.

Si la fonction réussit, la fonction retourne un HANDLE valide. Utilisez CloseHandle pour fermer ce handle.

Si une erreur se produit, la fonction retourne INVALID_HANDLE_VALUE.

Le paramètre uPortNumber accepte des valeurs de base unique. Avec la valeur 1 pour uPortNumber , cette fonction tente d’ouvrir COM1.

Pour prendre en charge UWP, créez un lien vers WindowsApp.lib.

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server, version 1709 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	OneCore.lib
DLL	KernelBase.dll