Compartilhar via


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:
  • O membro cbSize da estrutura deblobdeve ser tamanhos de(BTH_QUERY_DEVICE).
  • O membro pBlobData é um ponteiro para uma estrutura de BTH_QUERY_DEVICE, para a qual o membro LAP é o código de acesso de investigação Bluetooth, e o comprimento membro é o comprimento, em segundos, do inquérito.
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.

 

Bluetooth e WSALookupServiceBegin for Service Discovery

Bluetooth e WSALookupServiceNext

Bluetooth e WSAQUERYSET para de Consulta de Dispositivo

descobrindo dispositivos e serviços Bluetooth

WSALookupServiceBegin

WSALookupServiceNext

WSALookupServiceEnd

blob

BTH_QUERY_DEVICE

SOCKADDR_BTH

WSAQUERYSET

de Soquetes do Windows