Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
|---|---|
|
L’appel a réussi. Le tableau lpPortNumbers était suffisamment grand pour le résultat. |
|
Le tableau lpPortNumbers était trop petit pour contenir tous les numéros de port disponibles. |
|
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 |