Funzione GetCommProperties (winbase.h)

Articolo
03/03/2024

Recupera informazioni sulle proprietà delle comunicazioni per un dispositivo di comunicazione specificato.

Sintassi

BOOL GetCommProperties(
  [in]  HANDLE     hFile,
  [out] LPCOMMPROP lpCommProp
);

Parametri

[in] hFile

Handle per il dispositivo di comunicazione. La funzione CreateFile restituisce questo handle.

[out] lpCommProp

Puntatore a una struttura COMMPROP in cui vengono restituite le informazioni sulle proprietà delle comunicazioni. Queste informazioni possono essere usate nelle chiamate successive alla funzione SetCommState, SetCommTimeouts o SetupComm per configurare il dispositivo di comunicazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione GetCommProperties restituisce informazioni da un driver di dispositivo sulle impostazioni di configurazione supportate dal driver.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll