Função BluetoothAuthenticateMultipleDevices (bluetoothapis.h)

Artigo
02/26/2024

A função BluetoothAuthenticateMultipleDevices permite que o chamador solicite que vários dispositivos sejam autenticados durante uma única instância do assistente de Conexão Bluetooth.

ObservaçãoBluetoothAuthenticateMultipleDevices foi preterido. A implementação dessa API não é recomendada.

Sintaxe

DWORD BluetoothAuthenticateMultipleDevices(
  HWND                  hwndParent,
  HANDLE                hRadio,
  DWORD                 cDevices,
  BLUETOOTH_DEVICE_INFO *rgbtdi
);

Parâmetros

hwndParent

Uma janela para ser o pai do assistente de autenticação. Se definido como NULL, o assistente será pai da área de trabalho.

hRadio

O identificador de rádio local válido ou NULL. Se FOR NULL, a autenticação será tentada em todas as rádios locais; se qualquer rádio for bem-sucedido, a chamada de função terá êxito.

cDevices

O número de dispositivos na matriz pbtdi de estruturas de BLUETOOTH_DEVICE_INFO .

rgbtdi

Uma matriz de estruturas de BLUETOOTH_DEVICE_INFO que contêm registros para os dispositivos Bluetooth a serem autenticados.

Retornar valor

Retorna ERROR_SUCCESS após a conclusão bem-sucedida; marcar o sinalizador fAuthenticate para cada dispositivo.

A tabela a seguir lista erros comuns.

Código de retorno	Descrição
ERROR_CANCELLED	O usuário cancelou a operação. Verifique o sinalizador fAuthenticate para cada dispositivo Bluetooth para determinar se algum dispositivo foi autenticado antes do usuário cancelar a operação.
ERROR_INVALID_PARAMETER	Um ou mais dos dispositivos na matriz pbtdi não eram válidos.
ERROR_NO_MORE_ITEMS	Todos os dispositivos apontados por pbtdi já estão marcados como autenticados.

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