GetCommPorts, fonction (winbase.h)

Article
08/27/2023

Obtient un tableau qui contient les ports COM bien formés.

Cette fonction obtient les numéros de port COM à partir de la clé de Registre HKLM\Hardware\DeviceMap\SERIALCOMM , puis les écrit dans un tableau fourni par l’appelant. Si le tableau est trop petit, la fonction obtient la taille nécessaire.

Note Si de nouvelles entrées sont ajoutées à la clé de Registre, la taille nécessaire peut changer entre les appels d’API.

Syntaxe

ULONG GetCommPorts(
  [out] PULONG lpPortNumbers,
  [in]  ULONG  uPortNumbersCount,
  [out] PULONG puPortNumbersFound
);

Paramètres

[out] lpPortNumbers

Tableau pour les numéros de port.

[in] uPortNumbersCount

Longueur du tableau dans le paramètre lpPortNumbers .

[out] puPortNumbersFound

Nombre de numéros de port écrits dans l’objet lpPortNumbers ou longueur du tableau requis pour les numéros de port.

Valeur retournée

Code de retour	Description
ERROR_SUCCESS	L’appel a réussi. Le tableau lpPortNumbers était suffisamment grand pour le résultat.
ERROR_MORE_DATA	Le tableau lpPortNumbers était trop petit pour contenir tous les numéros de port disponibles.
ERROR_FILE_NOT_FOUND	Aucun port de communication n’est disponible.

Configuration requise


Client minimal pris en charge	Windows 10, version 1803 [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

Partager via