User manual - Bluetoothライブラリマニュアルver.1.08(2014年8月6日)

28
5.7 BTGetServiceInfo
Bluetooth 機器のサービス情報を取得します。
[C++]
LONG BTGetServiceInfo(
BTST_DEVICEINFO * DeviceInfo
)
[Visual Basic]
Public Shared Function BTGetServiceInfo( _
ByVal DeviceInfo As C:BluetoothLibNet+BTST_DEVICEINFO _
) As Int32
[C#]
public static Int32 BTGetServiceInfo(
C:BluetoothLibNet+BTST_DEVICEINFO DeviceInfo
);
解説
通信する Bluetooth 機器のサービス情報を取得します。
本関数は、BTGetDeviceInfo 関数で取得
した Bluetooth 機器のデバイス情報に加え、使用可能なプ
ロファイルの種類（BTST_DEVICEINFO 構造体の ProfileUUID）を取得します。取得可能なサービスク
ラスパラメータについては、「定数」を参
照してください。
本関数を実行する前に、BTGetDeviceInfo 関数を実行して、サービス情報以外のデバイス情報をあら
かじめ取得してください。
Device Emul
ator では、BTDeviceInfo[n].ini ファイルの情報を読み込みます。詳細は
BTDeviceInfo[n].ini を参
照してください。
パラメータ
DeviceInfo
Bluetooth 機器情報構造体を指定します。
戻り値
BTERR_SUCCESS
 正常終了
BTERR_FAILED
 Bluetooth 機器情報取得失敗
BTERR_DRIVER
 ドライバーエラー
DeviceEmulator では発生しません
FUNCTION_UNSUPPORT
 未サポートエラー
補足
本関数を実行しなくても、Bluetooth 機器との接続を行うことは可能です。サポートしている通信プロフ
ァイルの種類をチェックする場合に使用してください。Bluetooth 機器によっては、SDP(Service
Discovery Profile)をサポートしない等の理由で、使用可能なプロファイルの情報をを取得できない場
合があります。
本関数を実行後、再び BTGetDeviceInfo 関数を実
行すると、引数に格納された Bluetooth サービス
情報は消去されます。