Funzione GetCommPorts (winbase.h)

Ottiene una matrice contenente le porte COM ben formate.

Questa funzione ottiene i numeri di porta COM dalla chiave del Registro di sistema HKLM\Hardware\DeviceMap\SERIALCOMM e quindi li scrive in una matrice fornita dal chiamante. Se la matrice è troppo piccola, la funzione ottiene le dimensioni necessarie.

Nota Se le nuove voci vengono aggiunte alla chiave del Registro di sistema, le dimensioni necessarie possono cambiare tra le chiamate API.

 

Sintassi

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

Parametri

[out] lpPortNumbers

Matrice per i numeri di porta.

[in] uPortNumbersCount

Lunghezza della matrice nel parametro lpPortNumbers .

[out] puPortNumbersFound

Numero di numeri di porta scritti in lpPortNumbers o lunghezza della matrice necessaria per i numeri di porta.

Valore restituito

Codice restituito	Descrizione
ERROR_SUCCESS	La chiamata ha avuto esito positivo. La matrice lpPortNumbers è sufficientemente grande per il risultato.
ERROR_MORE_DATA	La matrice lpPortNumbers era troppo piccola per contenere tutti i numeri di porta disponibili.
ERROR_FILE_NOT_FOUND	Non sono disponibili porte comm.

Requisiti

Client minimo supportato	Windows 10 versione 1803 [app desktop | App UWP]
Server minimo supportato	Windows Server, versione 1709 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	OneCore.lib
DLL	KernelBase.dll