GetCommProperties, fonction (winbase.h)

Article
03/13/2024

Récupère des informations sur les propriétés de communication d’un appareil de communication spécifié.

Syntaxe

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

Paramètres

[in] hFile

Handle de l’appareil de communication. La fonction CreateFile retourne ce handle.

[out] lpCommProp

Pointeur vers une structure COMMPROP dans laquelle les informations des propriétés de communication sont retournées. Ces informations peuvent être utilisées dans les appels suivants à la fonction SetCommState, SetCommTimeouts ou SetupComm pour configurer l’appareil de communication.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction GetCommProperties retourne des informations d’un pilote de périphérique sur les paramètres de configuration pris en charge par le pilote.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll