BluetoothとWSAQUERYSET (デバイス照会用)
Bluetoothでは、WSAQUERYSET構造体を使用して、Bluetooth名前空間NS_BTHのデバイスとサービスの検出を容易にします。
WSALookupServiceBegin関数とWSALookupServiceNext関数は、WSAQUERYSET構造体を使用して、デバイスの照会プロセスに関する情報を取得します。 次の表に、WSAQUERYSET構造体のメンバー値とその説明を示します。
メンバー | LUP_CONTAINERSを指定したWSALookupServiceBeginへの入力 | WSALookupServiceNextから返された値 |
---|---|---|
dwSize | sizeof(WSAQUERYSET) に設定する必要があります。 | sizeof (WSAQUERYSET) がシステムによって返されます。 |
dwOutputFlags | 使用しません。 | これらのフラグの1つ以上を設定できます。BTHNS_RESULT_DEVICE_CONNECTEDデバイスが接続されていることを指定します。 BTHNS_RESULT_DEVICE_REMEMBEREDデバイスが記憶されているデバイスであることを指定します。 記憶されているすべてのデバイスが認証されているわけではありません。 BTHNS_RESULT_DEVICE_AUTHENTICATEDデバイスが認証、ペアリング、または結合されていることを指定します。 認証されたすべてのデバイスが記憶されます。 |
lpszServiceInstanceName | 使用しません。 | デバイスの表示名。最初はBluetoothリモート名要求操作から返され、ローカルユーザーによって更新される可能性があります。 LUP_RETURN_NAMEが指定されている場合に返されます。 |
lpServiceClassId | 使用しません。 | GUIDのData1メンバーにマップされているデバイス (COD) フィールドの32ビットBluetoothクラス。 LUP_RETURN_TYPEが指定されている場合に返されます。 |
lpVersion | 使用しません。 | 使用しません。 |
lpszComment | 使用しません。 | 使用しません。 |
dwNameSpace | NS_BTHにする必要があります。 | NS_BTHを返します。 |
lpNSProviderId | 使用しません。 | 使用しません。 |
lpszContext | 使用しません。 | 使用しません。 |
dwNumberOfProtocols | 使用しません。 | 使用しません。 |
lpafpプロトコル | 使用しません。 | 使用しません。 |
lpszQueryString | 使用しません。 | 使用しません。 |
dwNumberOfCsAddrs | 使用しません。 | CSADDR_INFO構造体の配列内の要素の数を示します。 |
lpcsaBuffer | 使用しません。 | リモートデバイスのアドレスを持つSOCKADDR_BTH構造体を指すLocalAddr.lpSockaddrメンバーを持つCSADDR_INFO構造体へのポインター。 LUP_RETURN_ADDRが指定されている場合に返されます。 |
lpBlob | 省略可能。 BTH_QUERY_DEVICE構造体を指すBLOB構造体を指す場合があります。これにより、キャッシュされていないデバイスの照会操作の長さが制限される可能性があります。 | BTH_DEVICE_INFO構造体を指すBLOB構造体へのポインター。 LUP_RETURN_BLOBが指定されている場合は、lpBlobが返されます。 BTH_DEVICE_INFOの名前フィールドを取得するには、LUP_RETURN_NAMEを指定します。 |