estructura de BTH_SET_SERVICE (ws2bth.h)
La estructura BTH_SET_SERVICE proporciona información de servicio para el servicio Bluetooth especificado.
Sintaxis
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;
Miembros
pSdpVersion
Versión del SDP. Los clientes establecen este miembro en BTH_SDP_VERSION.
pRecordHandle
Identificador del registro SDP. Corresponde a SDP ServiceRecordHandle. Devuelto por las operaciones de agregar registros y, posteriormente, se usa para eliminar el registro.
fCodService
Información de clase de dispositivo (COD). Campo de 32 bits de COD_SERVICE_* clase de bits de dispositivo asociados a este registro SDP. El sistema combina estos bits con bits COD de otros registros de servicio y características del sistema. La clase resultante de dispositivo para la radio local se anuncia cuando la radio se encuentra durante la consulta del dispositivo. Cuando se elimina el último registro SDP asociado a un bit de servicio determinado, ese bit de servicio ya no se notifica en respuestas a futuras consultas de dispositivos.
El formato y los valores posibles para el campo COD se definen en la parte Números asignados por Bluetooth 1.1 de la especificación Bluetooth, Sección 1.2. (Es posible que este recurso no esté disponible en algunos idiomas y países). Las macros y definiciones correspondientes para COD_SERVICE_* bits usados por Windows se definen en Bthdef.h. Para obtener más información sobre la clase de dispositivo (COD), consulte BTH_DEVICE_INFO.
Reserved[5]
Reservado. Debe establecerse en cero.
ulRecordLength
Tamaño, en bytes, de pRecord.
pRecord[1]
Registro SDP, tal como se define en la especificación bluetooth.
Comentarios
Al usar la estructura de BTH_SET_SERVICE para consultar servicios y dispositivos mediante la función WSASetService y las estructuras WSAQUERYSET y BLOB . Se deben usar los valores siguientes para BTH_SET_SERVICE miembros.
Para obtener más información sobre la clase de dispositivo (COD), consulte la especificación de Bluetooth en www.bluetooth.com.
| Miembro | Valor requerido |
|---|---|
| pSdpVersion | Puntero a la versión de ULONG, que se cambia cada vez que cambia el formato binario de los registros SDP, lo que afecta al formato del miembro pRecord . Establézcalo en BTH_SDP_VERSION para el cliente y devuelto por el sistema. |
| pRecordHandle | Identificador del registro SDP; corresponde a SDP ServiceRecordHandle. Devuelto por las operaciones de agregar registros y, posteriormente, se usa para eliminar el registro. |
| fOptions | Atributos definidos por BTHNS_SET_FLAGS. |
| ulRecordLength | Longitud, en bytes, del registro SDP binario al que apunta pRecord. |
| pRecord | Puntero a un registro SDP válido, en el formato definido por la especificación bluetooth. |
El miembro pRecordHandle debe apuntar a los datos que son null para el registro de nuevo servicio. Para la eliminación del servicio, pRecordHandle debe apuntar a un identificador válido. El miembro pRecord debe contener todo el registro del servicio SD, como se describe en la especificación bluetooth. Para las entradas del protocolo RFCOMM, el número de puerto es el mismo que el puerto devuelto por la llamada a la función getsockname .
Bluetooth implementa una correlación uno a uno entre registros SDP y sockets de servidor. Por lo tanto, no hay necesidad de la marca SERVICE_MULTIPLE .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Encabezado | ws2bth.h |