BTH_SET_SERVICE structure (ws2bth.h)
The BTH_SET_SERVICE structure provides service information for the specified Bluetooth service.
Syntax
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;
Members
pSdpVersion
Version of the SDP. Clients set this member to BTH_SDP_VERSION.
pRecordHandle
Handle to the SDP record. Corresponds to SDP ServiceRecordHandle. Returned by the add record operations, and subsequently used to delete the record.
fCodService
Class of device (COD) information. A 32-bit field of COD_SERVICE_* class of device bits associated with this SDP record. The system combines these bits with COD bits from other service records and system characteristics. The resulting class of device for the local radio is advertised when the radio is found during device inquiry. When the last SDP record associated with a particular service bit is deleted, that service bit is no longer reported in responses to future device inquiries.
The format and possible values for the COD field are defined in the Bluetooth Assigned Numbers 1.1 portion of the Bluetooth specification, Section 1.2. (This resource may not be available in some languages and countries.) Corresponding macros and definitions for COD_SERVICE_* bits used by Windows are defined in Bthdef.h. For more information about class of device (COD), see BTH_DEVICE_INFO.
Reserved[5]
Reserved. Must be set to zero.
ulRecordLength
Size, in bytes, of pRecord.
pRecord[1]
SDP record, as defined by the Bluetooth specification.
Remarks
When using the BTH_SET_SERVICE structure to query services and devices using the WSASetService function and WSAQUERYSET and BLOB structures. The following values for BTH_SET_SERVICE members must be used.
For more information about class of device (COD), see the Bluetooth specification at www.bluetooth.com.
| Member | Required value |
|---|---|
| pSdpVersion | Pointer to ULONG version, which is changed whenever the binary format of SDP records change, affecting the format of the pRecord member. Set to BTH_SDP_VERSION for the client, and returned by the system. |
| pRecordHandle | Handle to the SDP record; corresponds to SDP ServiceRecordHandle. Returned by the add record operations, and subsequently used to delete the record. |
| fOptions | Attributes defined by BTHNS_SET_FLAGS. |
| ulRecordLength | Length, in bytes, of the binary SDP record pointed to by pRecord. |
| pRecord | Pointer to a valid SDP record, in the format defined by the Bluetooth specification. |
The pRecordHandle member must point to data that is null for new service registration. For service deletion, pRecordHandle must point to a valid handle. The pRecord member must contain the entire SD service record, as described in the Bluetooth specification. For RFCOMM protocol entries, the port number is the same as the port returned by the getsockname function call.
Bluetooth implements a one-to-one correlation between SDP records and server sockets. As such, there is no need for the SERVICE_MULTIPLE flag.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP2 [desktop apps only] |
| Minimum supported server | None supported |
| Header | ws2bth.h |