BluetoothGetDeviceInfo 関数 (bluetoothapis.h)
BluetoothGetDeviceInfo 関数は、リモート Bluetooth デバイスに関する情報を取得します。 Bluetoothデバイスは、デバイス照会関数呼び出しが成功したことを通じて以前に識別されている必要があります。
構文
DWORD BluetoothGetDeviceInfo(
HANDLE hRadio,
BLUETOOTH_DEVICE_INFO *pbtdi
);
パラメーター
hRadio
BluetoothFindFirstRadio または同様の関数の呼び出し、または SetupDiEnumDeviceInterfaces 関数の呼び出しから取得されたローカル 無線へのハンドル。
pbtdi
最初のBluetooth デバイスに関するデータが配置される BLUETOOTH_DEVICE_INFO 構造体へのポインター。 詳細については、「解説」を参照してください。
戻り値
成功した ERROR_SUCCESS を返します。リモート Bluetooth デバイスに関するデータが取得されたことを示します。 エラー発生時にエラー コードを返します。 次の表に、BluetoothGetDeviceInfo 関数に関連付けられている一般的なエラー コードを示します。
| リターン コード | 形容 |
|---|---|
|
BLUETOOTH_DEVICE_INFOのサイズに互換性がありません。 BLUETOOTH_DEVICE_INFO 構造体の dwSize メンバーを確認します。 |
|
システムによって無線が認識されていないか、BLUETOOTH_DEVICE_INFO 構造体の Address メンバーがすべて 0 です。 |
|
|
備考
データが取得されるBluetoothデバイスは、デバイス照会関数呼び出しが成功したことを通じて以前に識別されている必要があります。
pbtdi
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista、WINDOWS XP SP2 [デスクトップ アプリのみ] |
| サポートされる最小サーバー | サポートされていません |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む) |
| ライブラリ | Bthprops.lib |
| DLL | bthprops.cpl |
関連項目
BLUETOOTH_DEVICE_SEARCH_PARAMS