Partager via

GetCommPorts, fonction (winbase.h)

  • Article

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