структура BTH_SET_SERVICE (ws2bth.h)
Структура BTH_SET_SERVICE предоставляет сведения о службе для указанной службы Bluetooth.
Синтаксис
typedef struct _BTH_SET_SERVICE {
PULONG pSdpVersion;
HANDLE *pRecordHandle;
ULONG fCodService;
ULONG Reserved[5];
ULONG ulRecordLength;
UCHAR pRecord[1];
} BTH_SET_SERVICE, *PBTH_SET_SERVICE, BTHNS_SETBLOB, *PBTHNS_SETBLOB;
Члены
pSdpVersion
Версия SDP. Клиенты устанавливают для этого элемента значение BTH_SDP_VERSION.
pRecordHandle
Дескриптор записи SDP. Соответствует SDP ServiceRecordHandle. Возвращается операциями добавления записей и затем используется для удаления записи.
fCodService
Сведения о классе устройства (COD). 32-разрядное поле класса COD_SERVICE_*, связанных с этой записью SDP. Система объединяет эти биты с битами COD из других записей службы и системных характеристик. Полученный класс устройства для локального радио объявляется при обнаружении радио во время исследования устройства. При удалении последней записи SDP, связанной с определенным битом службы, этот бит службы больше не сообщается в ответах на запросы устройств в будущем.
Формат и возможные значения для поля COD определяются в разделе Bluetooth Assigned Numbers 1.1 спецификации Bluetooth, раздел 1.2. (Этот ресурс может быть недоступен в некоторых языках и странах.) Соответствующие макросы и определения для битов COD_SERVICE_*, используемых Windows, определяются в Bthdef.h. Дополнительные сведения о классе устройства (COD) см. в разделе BTH_DEVICE_INFO.
Reserved[5]
Зарезервировано. Необходимо задать нулевое значение.
ulRecordLength
Размер pRecord в байтах.
pRecord[1]
Запись SDP, как определено в спецификации Bluetooth.
Комментарии
При использовании структуры BTH_SET_SERVICE для запроса служб и устройств с помощью функции WSASetService и структур WSAQUERYSET и BLOB . Для элементов BTH_SET_SERVICE необходимо использовать следующие значения.
Дополнительные сведения о классе устройства (COD) см. в спецификации Bluetooth на www.bluetooth.com.
| Член | Обязательное значение |
|---|---|
| pSdpVersion | Указатель на версию ULONG, которая изменяется при каждом изменении двоичного формата записей SDP, влияя на формат элемента pRecord . Задайте значение BTH_SDP_VERSION для клиента и возвращается системой. |
| pRecordHandle | Дескриптор записи SDP; соответствует SDP ServiceRecordHandle. Возвращается операциями добавления записей и затем используется для удаления записи. |
| fOptions | Атрибуты, определенные BTHNS_SET_FLAGS. |
| ulRecordLength | Длина в байтах двоичной записи SDP, на которую указывает pRecord. |
| pRecord | Указатель на допустимую запись SDP в формате, определенном спецификацией Bluetooth. |
Элемент pRecordHandle должен указывать на данные, имеющие значение NULL для регистрации новой службы. Для удаления службы pRecordHandle должен указывать на допустимый дескриптор. Элемент pRecord должен содержать всю запись службы SD, как описано в спецификации Bluetooth. Для записей протокола RFCOMM номер порта совпадает с портом, возвращенным вызовом функции getsockname .
Bluetooth реализует корреляцию "один к одному" между записями SDP и сокетами сервера. Таким образом, флаг SERVICE_MULTIPLE не требуется .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Верхняя часть | ws2bth.h |