Поделиться через

Функция BluetoothSetLocalServiceInfo (bluetoothapis.h)

  • Статья

Функция BluetoothSetLocalServiceInfo задает сведения о локальной службе для определенного радиосвязи Bluetooth.

Синтаксис

DWORD BluetoothSetLocalServiceInfo(
  [in, optional] HANDLE                             hRadioIn,
  [in]           const GUID                         *pClassGuid,
  [in]           ULONG                              ulInstance,
  [in]           const BLUETOOTH_LOCAL_SERVICE_INFO *pServiceInfoIn
);

Параметры

[in, optional] hRadioIn

Дескриптор радиоустройства Bluetooth для указания сведений о локальной службе. Если значение NULL, BluetoothSetLocalServiceInfo выполняет поиск первого доступного локального радиосвязи Bluetooth.

[in] pClassGuid

GUID службы для предоставления. Он должен соответствовать ИДЕНТИФИКАТОРу GUID в INF-файле на стороне сервера.

[in] ulInstance

Идентификатор экземпляра узла устройства с идентификатором Plug and Play (PnP).

[in] pServiceInfoIn

Указатель на структуру BLUETOOTH_LOCAL_SERVICE_INFO , описывающую заданную локальную службу.

Возвращаемое значение

Функция BluetoothSetLocalServiceInfo возвращает следующие значения:

Код возврата Описание
ERROR_NOT_FOUND
 Указанный радиосвязь Bluetooth не обнаружен.
ERROR_BAD_UNIT
 Радиосвязи Bluetooth не обнаружены.
STATUS_INSUFFICIENT_RESOURCES
 Недостаточно ресурсов для завершения операции. Эта ошибка может возникнуть, если службам Bluetooth соответствует более 100 локальных объектов физических устройств (POS).
STATUS_PRIVILEGE_NOT_HELD
 Вызывающий объект не имеет необходимых привилегий. Сведения о повышении привилегий см. в разделе Примечания.

Комментарии

BluetoothSetLocalServiceInfo — это API пользовательского режима, который используется только разработчиками драйверов профилей для активации установки локальной службы, описанной в GUID службы в pClassGuid.

BluetoothSetLocalServiceInfo создает идентификатор устройства Plug and Play (PnP) в виде BTHENUM{ClassGuid}. Например, "BTHENUM{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxx}". Приложения в пользовательском режиме могут вызывать BluetoothSetLocalServiceInfo в дальнейшем с тем же ИДЕНТИФИКАТОРом службы, но с другим идентификатором экземпляра, чтобы создать несколько экземпляров указанного профиля на стороне сервера.

Чтобы использовать API Bluetooth, такие как BluetoothSetLocalServiceInfo, приложения пользовательского режима должны связываться с BthProps.lib.

Предупреждение Процесс, вызывающий BluetoothSetLocalServiceInfo , должен иметь привилегию SE_LOAD_DRIVER_NAME . Процесс, выполняемый в системе или контексте администратора, может повысить свои привилегии с помощью функций Sdk LookupPrivilegeValue и AdjustTokenPrivileges . Дополнительные сведения об этом см. в статье Установка устройства Bluetooth.
 
Структура BLUETOOTH_LOCAL_SERVICE_INFO определяется в файле заголовка BluetoothApis.h пакета SDK.

Требования

Требование Значение
Минимальная версия клиента Versions:_Supported в Windows Vista и более поздних версий.
Целевая платформа Универсальное
Верхняя часть bluetoothapis.h
Библиотека BthProps.lib
DLL bthprops.cpl; BluetoothAPIs.dll

См. также раздел

BLUETOOTH_LOCAL_SERVICE_INFO