BluetoothEnumerateInstalledServices 関数 (bluetoothapis.h)

[アーティクル]
02/20/2025

BluetoothEnumerateInstalledServices 関数は、Bluetooth デバイスで有効になっているサービス GUID (グローバル一意識別子) を列挙します。

構文

DWORD BluetoothEnumerateInstalledServices(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  DWORD                       *pcServiceInout,
  GUID                        *pGuidServices
);

パラメーター

hRadio

ローカル Bluetooth 無線デバイスのハンドル。 NULL の場合、すべてのローカル無線は pbtdi の無線アドレスと一致する有効なサービスを検索します。

pbtdi

BLUETOOTH_DEVICE_INFO構造体へのポインター。

pcServiceInout

入力時に、 pGuidServices パラメーターによって指されるレコードの数。出力時に、 pGuidServices パラメーターで返される有効なレコードの数。 pGuidServices が NULL の場合、出力 pcServices には有効なサービスの数が含まれます。

pGuidServices

インストールされているサービスの GUID を受信するためのメモリ内のバッファーへのポインター。バッファーは、少なくとも *pcServices *sizeof(GUID) バイトである必要があります。

戻り値

正常に完了するとERROR_SUCCESSを返し、pGuidServices パラメーターには有効なサービス GUID の完全な一覧が含まれます。

次の表では、一般的なエラーについて説明します。

リターンコード	説明
ERROR_MORE_DATA	呼び出しは成功しました。 pGuidServices パラメーターには、有効なサービス GUID の不完全な一覧が含まれています。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	bluetoothapis.h (Bthsdpdef.h、BluetoothAPIs.h を含む)
Library	Bthprops.lib
[DLL]	bthprops.cpl