Leggere in inglese

Condividi tramite

Funzione GetCommPorts (winbase.h)

  • Articolo

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

C++ 
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