Condividi tramite

Bluetooth e WSAQUERYSET per richiesta di servizi

  • Articolo

Bluetooth usa la struttura diWSAQUERYSET, con varie funzioni, per facilitare l'individuazione di dispositivi e servizi nello spazio dei nomi Bluetooth, NS_BTH.

Le funzioni WSALookupServiceBegin e WSALookupServiceNext usano la struttura di WSAQUERYSET per ottenere dati sul processo di richiesta del servizio. Nella tabella seguente viene descritto come impostare i valori dei membri nella struttura WSAQUERYSET per questo scopo.

Membro Input per WSALookupServiceBegin Valore restituito da WSALookupServiceNext
dwSize Deve essere impostato su sizeof(WSAQUERYSET). sizeof(WSAQUERYSET) restituito dal sistema.
dwOutputFlags Non utilizzato. Non utilizzato.
lpszServiceInstanceName Non utilizzato. Nome visualizzato del servizio, convertito come stringa con codifica UTF-8 dalla codifica della lingua predefinita dell'attributo SDP NomeServizio Bluetooth. Restituito se viene specificato LUP_RETURN_NAME.
lpServiceClassId Obbligatorio. L'UUID Bluetooth più specifico per i servizi per cui viene eseguita la ricerca. Ad esempio, se questo valore è impostato sull'UUID del protocollo L2CAP, restituisce tutti i servizi che usano il protocollo L2CAP nel dispositivo di destinazione. Se impostato sull'UUID di un servizio specifico, restituirà solo le istanze di tale servizio. Non utilizzato.
lpVersion Non utilizzato. Non utilizzato.
lpszComment Non utilizzato. Descrizione del servizio, convertito come stringa con codifica UTF-8 dalla codifica della lingua predefinita dell'attributo SDP ServiceDescription Bluetooth. Restituito se viene specificato LUP_RETURN_COMMENT.
dwNameSpace Deve essere NS_BTH. Restituisce NS_BTH.
lpNSProviderId Non utilizzato. Non utilizzato.
lpszContext Obbligatorio. Indirizzo del dispositivo Bluetooth con cui stabilire una connessione SDP ed eseguire query per i servizi. Questo valore deve essere una stringa convertita tramite la chiamata di funzione WSAAddressToString. Se viene specificato l'indirizzo del dispositivo Bluetooth locale, viene eseguita la ricerca del database SDP locale. Non utilizzato.
dwNumberOfProtocols Non utilizzato. Non utilizzato.
lpafpProtocols Non utilizzato. Non utilizzato.
lpszQueryString Non utilizzato. Non utilizzato.
dwNumberOfCsAddrs Non utilizzato. Indica il numero di elementi nella matrice di strutture CSADDR_INFO.
lpcsaBuffer Non utilizzato. Puntatore a una struttura CSADDR_INFO la cui LocalAddr.lpSockaddr membro punta a un SOCKADDR_BTH che contiene l'indirizzo collegabile completo del servizio remoto, convertito dalla prima voce dell'attributo SDP ProtocolDescriptorList Bluetooth. Restituito se viene specificato LUP_RETURN_ADDR.
lpBlob Opzionale. Puntatore a una struttura BTH_QUERY_SERVICE che contiene parametri avanzati per limitare i risultati della ricerca. Se specificato, lpServiceClassId viene ignorato e le query memorizzate nella cache non hanno esito positivo.
  • Se viene eseguita una ricerca del servizio: puntatore a una strutturaBLOBche restituisce gli handle del servizio. (BLOB.cbSize)/sizeof(ULONG) calcola il numero di handle. BLOB.pBlobData è una matrice di valori ULONG che rappresentano gli handle del servizio.
  • Se viene eseguita una ricerca di attributo o serviceAttribute: puntatore a una strutturaBLOBche restituisce il record SDP binario. BLOB.cbSize è la dimensione del record SDP binario. BLOB.pBlobData punta al record stesso. Il record SDP binario è necessario in molti casi perché solo un numero limitato di attributi SDP può essere convertito nella struttura di WSAQUERYSET e vengono convertite solo le stringhe UTF-8 codificate predefinite. Le funzioni per facilitare l'analisi del record SDP binario sono disponibili nella sezione riferimento Bluetooth.
  • Restituito se viene specificato LUP_RETURN_BLOB.

 

Bluetooth e WSAQUERYSET per set service

Bluetooth e WSAQUERYSET per la richiesta di dispositivi

Bluetooth e BLOB

Bluetooth e WSALookupServiceBegin

Bluetooth e WSALookupServiceNext

di riferimento Bluetooth

BLOB

BTH_QUERY_SERVICE

CSADDR_INFO

SOCKADDR_BTH

WSAAddressToString

WSAQUERYSET

Windows Sockets