Función GetCommProperties (winbase.h)

Artículo
03/03/2024

Recupera información sobre las propiedades de comunicaciones de un dispositivo de comunicaciones especificado.

Sintaxis

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

Parámetros

[in] hFile

Identificador del dispositivo de comunicaciones. La función CreateFile devuelve este identificador.

[out] lpCommProp

Puntero a una estructura COMMPROP en la que se devuelve la información de las propiedades de comunicaciones. Esta información se puede usar en llamadas posteriores a la función SetCommState, SetCommTimeouts o SetupCommComm para configurar el dispositivo de comunicaciones.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función GetCommProperties devuelve información de un controlador de dispositivo sobre las opciones de configuración admitidas por el controlador.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	winbase.h (incluye Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll