estrutura BTH_SET_SERVICE (ws2bth.h)
A estrutura BTH_SET_SERVICE fornece informações de serviço para o serviço Bluetooth especificado.
Sintaxe
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;
Membros
pSdpVersion
Versão do SDP. Os clientes definem esse membro como BTH_SDP_VERSION.
pRecordHandle
Identificador para o registro SDP. Corresponde a ServiceRecordHandle do SDP. Retornado pelas operações de adição de registro e, posteriormente, usado para excluir o registro.
fCodService
Informações de COD (classe de dispositivo). Um campo de 32 bits da classe COD_SERVICE_* de bits de dispositivo associados a esse registro SDP. O sistema combina esses bits com bits COD de outros registros de serviço e características do sistema. A classe resultante de dispositivo para o rádio local é anunciada quando o rádio é encontrado durante a consulta do dispositivo. Quando o último registro SDP associado a um bit de serviço específico é excluído, esse bit de serviço não é mais relatado em respostas a consultas futuras do dispositivo.
O formato e os valores possíveis para o campo COD são definidos na parte Números Atribuídos por Bluetooth 1.1 da especificação Bluetooth, Seção 1.2. (Esse recurso pode não estar disponível em alguns idiomas e países.) Macros e definições correspondentes para bits COD_SERVICE_* usados pelo Windows são definidas em Bthdef.h. Para obter mais informações sobre a classe de dispositivo (COD), consulte BTH_DEVICE_INFO.
Reserved[5]
Reservado. Deve ser definido como zero.
ulRecordLength
Tamanho, em bytes, de pRecord.
pRecord[1]
Registro SDP, conforme definido pela especificação bluetooth.
Comentários
Ao usar a estrutura BTH_SET_SERVICE para consultar serviços e dispositivos usando a função WSASetService e estruturas WSAQUERYSET e BLOB . Os valores a seguir para membros BTH_SET_SERVICE devem ser usados.
Para obter mais informações sobre COD (classe de dispositivo), consulte a especificação bluetooth em www.bluetooth.com.
| Membro | Valor obrigatório |
|---|---|
| pSdpVersion | Ponteiro para a versão do ULONG, que é alterada sempre que o formato binário dos registros SDP é alterado, afetando o formato do membro pRecord . Defina como BTH_SDP_VERSION para o cliente e retornado pelo sistema. |
| pRecordHandle | Identificador para o registro SDP; corresponde a ServiceRecordHandle do SDP. Retornado pelas operações de adição de registro e, posteriormente, usado para excluir o registro. |
| fOptions | Atributos definidos por BTHNS_SET_FLAGS. |
| ulRecordLength | Comprimento, em bytes, do registro SDP binário apontado por pRecord. |
| pRecord | Ponteiro para um registro SDP válido, no formato definido pela especificação bluetooth. |
O membro pRecordHandle deve apontar para dados que são nulos para o novo registro de serviço. Para exclusão de serviço, pRecordHandle deve apontar para um identificador válido. O membro pRecord deve conter todo o registro de serviço SD, conforme descrito na especificação bluetooth. Para entradas de protocolo RFCOMM, o número da porta é o mesmo que a porta retornada pela chamada de função getsockname .
O Bluetooth implementa uma correlação um-para-um entre registros SDP e soquetes de servidor. Dessa forma, não há necessidade do sinalizador SERVICE_MULTIPLE .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Cabeçalho | ws2bth.h |