estructura BTH_DEVICE_INFO (bthdef.h)

La estructura BTH_DEVICE_INFO almacena información sobre un dispositivo Bluetooth.

Sintaxis

typedef struct _BTH_DEVICE_INFO {
  ULONG    flags;
  BTH_ADDR address;
  BTH_COD  classOfDevice;
  CHAR     name[BTH_MAX_NAME_SIZE];
} BTH_DEVICE_INFO, *PBTH_DEVICE_INFO;

Miembros

flags

Combinación de una o varias de las marcas enumeradas en la tabla siguiente.

Valor	Significado
BDIF_ADDRESS	El miembro de dirección contiene datos válidos.
BDIF_COD	El miembro classOfDevice contiene datos válidos.
BDIF_NAME	El miembro de nombre contiene datos válidos.
BDIF_PAIRED	El dispositivo es un dispositivo recordado y autenticado. La marca BDIF_PERSONAL siempre se establece cuando se establece esta marca.
BDIF_PERSONAL	El dispositivo es un dispositivo recordado. Si se establece esta marca y no se establece la marca BDIF_PAIRED , el dispositivo no se autentica.
BDIF_CONNECTED	El dispositivo Bluetooth remoto está conectado actualmente a la radio local.
BDIF_SSP_SUPPORTED	El dispositivo admite el uso de emparejamiento simple seguro (SSP).
BDIF_SSP_PAIRED	El dispositivo se recuerda y se autentica mediante el emparejamiento simple seguro (SSP).
BDIF_SSP_MITM_PROTECTED	El dispositivo admite el uso de emparejamiento simple seguro (SSP) para protegerse contra ataques "Man in the Middle".

address

Dirección del dispositivo Bluetooth remoto.

classOfDevice

Campo de bits que describe la clase de dispositivo del dispositivo (COD) del dispositivo remoto. El COD consta de los cuatro campos siguientes:

Formato: recuperado mediante GET_COD_FORMAT(classOfDevice). El único formato admitido actualmente es COD_VERSION.

Principal: recuperado mediante el GET_COD_MAJOR(classOfDevice). Actualmente se definen los siguientes valores, pero se espera que la lista se expanda. No use el campo de clase principal para determinar a qué dispositivo remoto se va a conectar. Un dispositivo remoto solo puede tener un código de clase principal y es posible que no sea el código adecuado para el perfil especificado.

COD_MAJOR_MISCELLANEOUS

COD_MAJOR_COMPUTER

COD_MAJOR_PHONE

COD_MAJOR_LAN_ACCESS

COD_MAJOR_AUDIO

COD_MAJOR_PERIPHERAL

COD_MAJOR_IMAGING

COD_MAJOR_UNCLASSIFIED

Menor: recuperado mediante GET_COD_MINOR(classOfDevice). El código secundario es específico de cada código principal, que define cómo se da formato a su código secundario. Algunos códigos secundarios son valores estrictamente enumerados; otros son campos de bits o una combinación de campos de bits y valores enumerados.

Sugerencias de servicio: recuperadas mediante el GET_COD_SERVICE(classOfDevice). Proporciona sugerencias sobre la funcionalidad del dispositivo remoto.

COD_SERVICE_LIMITED

COD_SERVICE_POSITIONING

COD_SERVICE_NETWORKING

COD_SERVICE_RENDERING

COD_SERVICE_CAPTURING

COD_SERVICE_OBJECT_XFER

COD_SERVICE_AUDIO

COD_SERVICE_TELEPHONY

COD_SERVICE_INFORMATION

name[BTH_MAX_NAME_SIZE]

Nombre del dispositivo Bluetooth remoto, según lo indicado por el dispositivo, codificado en UTF8. El usuario puede haber proporcionado localmente un nombre para mostrar para el dispositivo Bluetooth remoto; ese nombre se invalida y no aparece en este miembro; solo es accesible con una llamada a la función BluetoothGetDeviceInfo .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Encabezado	bthdef.h

Consulte también

BTH_QUERY_DEVICE

BTH_QUERY_SERVICE

BTH_SET_SERVICE

BluetoothGetDeviceInfo