Função BluetoothEnableDiscovery (bluetoothapis.h)

Artigo
02/26/2024

A função BluetoothEnableDiscovery altera o estado de descoberta de um rádio ou rádio Bluetooth local.

Sintaxe

BOOL BluetoothEnableDiscovery(
  HANDLE hRadio,
  BOOL   fEnabled
);

Parâmetros

hRadio

Identificador de rádio local válido ou NULL. Se FOR NULL, a descoberta será modificada em todas as rádios locais; se qualquer rádio for modificado pela chamada, a chamada de função terá êxito.

fEnabled

Sinalizador especificando se a descoberta deve ser habilitada ou desabilitada. Defina como TRUE para habilitar a descoberta, defina como FALSE para desabilitar a descoberta.

Retornar valor

Retorna TRUE se o estado de descoberta foi alterado com êxito. Se hRadio for NULL, um valor retornado de TRUE indicará que pelo menos um estado de rádio local foi alterado com êxito. Retornará FALSE se o estado de descoberta não tiver sido alterado; se hRadio era NULL, nenhum rádio aceitou a alteração de estado.

Comentários

Use a função BluetoothIsDiscoverable para determinar o estado atual de um rádio Bluetooth. O Windows garante que um sistema detectável seja conectável e, como tal, o rádio deve permitir conexões de entrada antes de tornar um rádio detectável. A falha ao permitir conexões de entrada resulta na falha na chamada da função BluetoothEnableDiscovery .

Quando BluetoothEnableDiscovery altera o estado de descoberta, o novo estado é válido durante o tempo de vida do aplicativo de chamada. Além disso, se um rádio Bluetooth anteriormente tornado detectável com essa função estiver desabilitado e reabilitado por meio do aplicativo, a capacidade de descoberta não persistirá. Depois que o aplicativo de chamada é encerrado, o estado de descoberta do rádio Bluetooth especificado é revertido para o estado em que estava antes de BluetoothEnableDiscovery ser chamado.

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