Функция BluetoothUpdateDeviceRecord (bluetoothapis.h)
Функция BluetoothUpdateDeviceRecord обновляет кэш локального компьютера об устройстве Bluetooth.
Синтаксис
DWORD BluetoothUpdateDeviceRecord(
const BLUETOOTH_DEVICE_INFO *pbtdi
);
Параметры
pbtdi
Указатель на обновляемую структуру BLUETOOTH_DEVICE_INFO . Дополнительные сведения см. в разделе «Примечания».
Возвращаемое значение
Возвращает ERROR_SUCCESS при успешном выполнении. В следующей таблице перечислены распространенные ошибки.
| Код возврата | Описание |
|---|---|
|
Параметр pbtdi имеет значение NULL. |
|
Недопустимый член dwSize структуры, на который указывает параметр pbtdi . |
Комментарии
При обновлении записи устройства Bluetooth необходимо соблюдать требования к членам структуры BLUETOOTH_DEVICE_INFO , перечисленные в следующей таблице.
| Член | Требование |
|---|---|
| dwSize | Должен соответствовать размеру структуры. |
| Адрес | Должен быть ранее найденным радиоадресом. |
| szName | Должно содержать новое имя для сохранения. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | bluetoothapis.h (включая Bthsdpdef.h, BluetoothAPIs.h) |
| Библиотека | Bthprops.lib |
| DLL | bthprops.cpl |
См. также раздел
BLUETOOTH_DEVICE_SEARCH_PARAMS