Compartilhar via


Função BluetoothUpdateDeviceRecord (bluetoothapis.h)

A função BluetoothUpdateDeviceRecord atualiza o cache do computador local sobre um dispositivo Bluetooth.

Sintaxe

DWORD BluetoothUpdateDeviceRecord(
  const BLUETOOTH_DEVICE_INFO *pbtdi
);

Parâmetros

pbtdi

Um ponteiro para a estrutura BLUETOOTH_DEVICE_INFO a ser atualizada. Para obter mais informações, consulte a seção Comentários.

Retornar valor

Retorna ERROR_SUCCESS após o sucesso. A tabela a seguir lista erros comuns.

Código de retorno Descrição
ERROR_INVALID_PARAMETER
O parâmetro pbtdi é NULL.
ERROR_REVISION_MISMATCH
O membro dwSize da estrutura apontada no parâmetro pbtdi não é válido.

Comentários

Ao atualizar um registro de dispositivo Bluetooth, os requisitos para membros da estrutura BLUETOOTH_DEVICE_INFO , listados na tabela a seguir, devem ser observados.

Membro Requisito
dwSize Deve corresponder ao tamanho da estrutura.
Endereço Deve ser um endereço de rádio encontrado anteriormente.
szName Deve conter o novo nome a ser armazenado.

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_DEVICE_INFO

BLUETOOTH_DEVICE_SEARCH_PARAMS

BluetoothDisplayDeviceProperties

BluetoothFindDeviceClose

BluetoothFindFirstDevice

BluetoothFindNextDevice

BluetoothGetDeviceInfo

BluetoothRemoveDevice