Função BluetoothFindNextDevice (bluetoothapis.h)

Artigo
02/26/2024

A função BluetoothFindNextDevice localiza o próximo dispositivo Bluetooth.

Sintaxe

BOOL BluetoothFindNextDevice(
  HBLUETOOTH_DEVICE_FIND hFind,
  BLUETOOTH_DEVICE_INFO  *pbtdi
);

Parâmetros

hFind

Manipule para a consulta obtida em uma chamada anterior para a função BluetoothFindFirstDevice .

pbtdi

Ponteiro para uma estrutura BLUETOOTH_DEVICE_INFO na qual as informações sobre o próximo 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 BluetoothFindNextDevice falha.

Retornar valor

Retorna TRUE quando o próximo dispositivo é encontrado com êxito e o parâmetro pbtdi aponta para informações sobre o dispositivo. Retorna FALSE após o erro. 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_HANDLE	O identificador é NULL.
ERROR_NO_MORE_ITEMS	Não foram encontrados mais dispositivos.
ERROR_OUTOFMEMORY	Sem memória.

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