Compartilhar via

Função BluetoothSelectDevices (bluetoothapis.h)

  • Artigo

A função BluetoothSelectDevices habilita a seleção de dispositivo Bluetooth.

Sintaxe

BOOL BluetoothSelectDevices(
  BLUETOOTH_SELECT_DEVICE_PARAMS *pbtsdp
);

Parâmetros

pbtsdp

Um ponteiro para uma estrutura BLUETOOTH_SELECT_DEVICE_PARAMS que identifica dispositivos Bluetooth.

Retornar valor

Retorna TRUE se um usuário selecionou um dispositivo.

Retornará FALSE se nenhum dado válido tiver sido retornado. Chame a função GetLastError para recuperar informações de erro. As condições a seguir se aplicam às informações de erro retornadas.

Código de retorno Descrição
ERROR_CANCELLED
 O usuário cancelou a solicitação.
ERROR_INVALID_PARAMETER
 O parâmetro pbtsdp é NULL.
ERROR_REVISION_MISMATCH
 A estrutura passada em pbtsdp é de tamanho desconhecido.

Comentários

A função BluetoothSelectDevices abre uma caixa de diálogo comum para selecionar dispositivos Bluetooth. A lista de dispositivos exibidos para o usuário é determinada pelos sinalizadores e pelas configurações especificadas pelo chamador no parâmetro pbtsdp .

Se BluetoothSelectDevices retornar TRUE, o membro pDevices da estrutura BLUETOOTH_SELECT_DEVICE_PARAMS apontará para dados válidos. O chamador deve verificar se os sinalizadores fAuthenticated e fRemembered na estrutura BLUETOOTH_SELECT_DEVICE_PARAMS para determinar quais dispositivos foram autenticados com êxito e quais dispositivos são seleções válidas para o usuário. Chame a função BluetoothSelectDevicesFree para liberar recursos somente se a função BluetoothSelectDevices retornar TRUE.

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

Confira também

BLUETOOTH_SELECT_DEVICE_PARAMS

PFN_DEVICE_CALLBACK