Bluetooth e WSALookupServiceBegin for Device Inquiry
Este tópico descreve como usar a função WSALookupServiceBegin para executar uma investigação de dispositivos visíveis e fantasmas. Para obter mais informações, consulte Descobrindo dispositivos e serviços Bluetooth.
A função WSALookupServiceBegin usa uma estrutura WSAQUERYSET em seu primeiro parâmetro, lpqsRestrictions, para definir critérios de pesquisa. O Bluetooth fornece diretrizes específicas para o uso da função WSALookupServiceBegin e WSAQUERYSET.
A tabela a seguir lista as restrições que se aplicam à estrutura deWSAQUERYSET passada para o parâmetro lpqsRestrictions ao consultar dispositivos.
Membro WSAQUERYSET | Restrição |
---|---|
dwSize | Defina como tamanhos de(WSAQUERYSET). |
lpBlob | Esse membro contém um ponteiro opcional para uma estrutura deblob. Se esse membro for especificado, os parâmetros de consulta de dispositivo válidos para LUP_FLUSHCACHE serão os seguintes:
|
dwNameSpace | Definido como NS_BTH. |
Outros membros | Outros membros da estrutura deWSAQUERYSETsão ignorados. |
Os sinalizadores listados na tabela a seguir são usados no parâmetro dwControlFlags para controlar os resultados da consulta. Os sinalizadores LUP_CONTAINERS e LUP_FLUSHCACHE são usados pela funçãoWSALookupServiceBegin; o restante dos sinalizadores são usados em chamadas para a funçãoWSALookupServiceNext.
Bandeira | Resultado |
---|---|
LUP_CONTAINERS | Especifica que a finalidade da consulta é obter uma lista de dispositivos Bluetooth e não uma lista de serviços. Esse sinalizador deve ser definido. |
LUP_FLUSHCACHE | Dispara uma consulta de dispositivos locais ou faz com que os resultados armazenados em cache de consultas anteriores sejam retornados. |
LUP_RETURN_TYPE | Retorne o COD Bluetooth (classe de bits de dispositivo) diretamente no lpServiceClassId membro da estrutura deWSAQUERYSET. O COD é mapeado para o membro data1 do do GUID. |
LUP_RES_SERVICE | Retornar informações para o endereço Bluetooth local. Esse sinalizador só terá efeito se LUP_RETURN_ADDR também for especificado. |
LUP_RETURN_NAME | Retorne o nome de exibição do dispositivo no lpszServiceInstanceName membro da estrutura deWSAQUERYSET para cada chamada para a função WSALookupServiceNext. Esse sinalizador também deve ser especificado para recuperar o nome membro da estrutura BTH_DEVICE_INFO ao especificar o sinalizador LUP_RETURN_BLOB. |
LUP_RETURN_ADDR | Retorne uma estrutura de SOCKADDR_BTH que contém o endereço de 48 bits do par no lpcsaBuffer membro da estruturaWSAQUERYSET para cada chamada para a função WSALookupServiceNext. Outros membros na estrutura SOCKADDR_BTH estarão vazios. |
LUP_RETURN_BLOB | Retorne a estrutura de BTH_DEVICE_INFO em cada chamada subsequente para WSALookupServiceNext . |
LUP_FLUSHPREVIOUS | Ignore o próximo dispositivo disponível e retorne o dispositivo que o segue. |
Tópicos relacionados
-
Bluetooth e WSAQUERYSET para de Consulta de Dispositivo