Função BluetoothGetDeviceInfo (bluetoothapis.h)

Artigo
07/25/2024

A função BluetoothGetDeviceInfo recupera informações sobre um dispositivo Bluetooth remoto. O dispositivo Bluetooth deve ter sido identificado anteriormente por meio de uma chamada de função de consulta de dispositivo bem-sucedida.

Sintaxe

DWORD BluetoothGetDeviceInfo(
  HANDLE                hRadio,
  BLUETOOTH_DEVICE_INFO *pbtdi
);

Parâmetros

hRadio

Um identificador para um rádio local, obtido de uma chamada para o BluetoothFindFirstRadio ou funções semelhantes, ou de uma chamada para a função SetupDiEnumDeviceInterfaces.

pbtdi

Um ponteiro para uma estrutura BLUETOOTH_DEVICE_INFO na qual os dados sobre o primeiro dispositivo Bluetooth serão colocados. Para obter mais informações, consulte Comentários.

Valor de retorno

Retorna ERROR_SUCCESS após o sucesso, indicando que os dados sobre o dispositivo Bluetooth remoto foram recuperados. Retorna códigos de erro após falha. A tabela a seguir lista códigos de erro comuns associados à função BluetoothGetDeviceInfo .

Código de retorno	Descrição
ERROR_REVISION_MISMATCH	O tamanho do BLUETOOTH_DEVICE_INFO não é compatível. Verifique o dwSize membro da estrutura de BLUETOOTH_DEVICE_INFO.
ERROR_NOT_FOUND	O rádio não é conhecido pelo sistema ou o Address membro da estrutura BLUETOOTH_DEVICE_INFO é todos zeros.
ERROR_INVALID_PARAMETER	O parâmetro pbtdi é NULL.

Observações

O dispositivo Bluetooth para o qual os dados são obtidos deve ter sido identificado anteriormente por meio de uma chamada de função de consulta de dispositivo bem-sucedida.

Na estrutura BLUETOOTH_DEVICE_INFO apontada por pbtdi, o membro dwSize deve ser equivalente ao tamanho, em bytes, da estrutura. O Address membro da estrutura BLUETOOTH_DEVICE_INFO deve conter o endereço Bluetooth do dispositivo remoto.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Nenhum com suporte
da Plataforma de Destino	Windows
cabeçalho	bluetoothapis.h (inclua Bthsdpdef.h, BluetoothAPIs.h)
biblioteca	Bthprops.lib
de DLL	bthprops.cpl

Consulte também

BLUETOOTH_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothRemoveDevice

Compartilhar via