Função BluetoothFindFirstDevice (bluetoothapis.h)

Artigo
02/23/2024

A função BluetoothFindFirstDevice inicia os dispositivos Bluetooth de enumeração.

Sintaxe

HBLUETOOTH_DEVICE_FIND BluetoothFindFirstDevice(
  const BLUETOOTH_DEVICE_SEARCH_PARAMS *pbtsp,
  BLUETOOTH_DEVICE_INFO                *pbtdi
);

Parâmetros

pbtsp

Ponteiro para uma estrutura BLUETOOTH_DEVICE_SEARCH_PARAMS . O membro dwSize da estrutura BLUETOOTH_DEVICE_SEARCH_PARAMS apontada pelo pbtsp deve corresponder ao tamanho da estrutura.

pbtdi

Ponteiro para uma estrutura BLUETOOTH_DEVICE_INFO na qual as informações sobre o primeiro dispositivo Bluetooth encontrado são colocadas. O membro dwSize da estrutura BLUETOOTH_DEVICE_INFO apontada por pbtdi deve corresponder ao tamanho da estrutura ou a chamada para a função BluetoothFindFirstDevice falha.

Retornar valor

Retorna um identificador válido para o primeiro dispositivo Bluetooth após a conclusão bem-sucedida e o parâmetro pbtdi aponta para informações sobre o dispositivo. Quando esse identificador não for mais necessário, ele deverá ser fechado por meio do BluetoothFindDeviceClose.

Retorna NULL após falha. Chame a função GetLastError para obter mais informações sobre o erro. A tabela a seguir descreve erros comuns:

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	O parâmetro pbtsp ou pbtdi é NULL.
ERROR_REVISION_MISMATCH	A estrutura apontada por pbtsp ou pbtdi não é do tamanho correto.

Comentários

A função BluetoothFindFirstDevice não encontra dispositivos BLUETOOTH de baixa energia (LE). Para acessar dispositivos Bluetooth LE, use as APIs Windows Runtime Bluetooth de baixa energia. As APIs Windows Runtime para Bluetooth funcionam em aplicativos da área de trabalho clássicos e UWP.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	bluetoothapis.h (inclua Bthsdpdef.h, BluetoothAPIs.h)
Biblioteca	Bthprops.lib
DLL	bthprops.cpl