Share via

BluetoothSetLocalServiceInfo 関数 (bluetoothapis.h)

  • [アーティクル]

BluetoothSetLocalServiceInfo 関数は、特定の Bluetooth 無線のローカル サービス情報を設定します。

構文

DWORD BluetoothSetLocalServiceInfo(
  [in, optional] HANDLE                             hRadioIn,
  [in]           const GUID                         *pClassGuid,
  [in]           ULONG                              ulInstance,
  [in]           const BLUETOOTH_LOCAL_SERVICE_INFO *pServiceInfoIn
);

パラメーター

[in, optional] hRadioIn

ローカル サービス情報を指定する Bluetooth 無線デバイスのハンドル。 NULL の場合、BluetoothSetLocalServiceInfo は利用可能な最初のローカル Bluetooth 無線を検索します。

[in] pClassGuid

公開するサービスの GUID。 これは、サーバー側 INF ファイルの GUID と 一致する必要があります。

[in] ulInstance

プラグ アンド プレイ (PnP) ID のデバイス ノードのインスタンス ID。

[in] pServiceInfoIn

設定するローカル サービスを記述する BLUETOOTH_LOCAL_SERVICE_INFO 構造体へのポインター。

戻り値

BluetoothSetLocalServiceInfo 関数は、次の値を返します。

リターン コード 説明
ERROR_NOT_FOUND
 指定された Bluetooth 無線が検出されませんでした。
ERROR_BAD_UNIT
 Bluetooth 無線は検出されませんでした。
STATUS_INSUFFICIENT_RESOURCES
 操作を完了するのに十分なリソースが利用できませんでした。 このエラーは、100 を超えるローカル物理デバイス オブジェクト (PDO) が Bluetooth サービスに対応している場合に発生する可能性があります。
STATUS_PRIVILEGE_NOT_HELD
 呼び出し元には、必要な特権がありません。 特権を昇格する方法については、「解説」セクションを参照してください。

注釈

BluetoothSetLocalServiceInfo は、プロファイル ドライバー開発者のみが pClassGuid のサービス GUID で説明されているローカル サービスのインストールをトリガーするために使用されるユーザー モード API です。

BluetoothSetLocalServiceInfo は、"BTHENUM{ClassGuid}" の形式でプラグ アンド プレイ (PnP) デバイス ID を生成します。 たとえば、"BTHENUM{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}" などです。 ユーザー モード アプリケーションは、同じサービス GUID を使用して BluetoothSetLocalServiceInfo をそれ以降呼び出すことができますが、インスタンス ID が異なって、指定されたサーバー側プロファイルの複数のインスタンスを作成できます。

BluetoothSetLocalServiceInfo などの Bluetooth API を使用するには、ユーザー モード アプリケーションを BthProps.lib とリンクする必要があります。

警告BluetoothSetLocalServiceInfo を呼び出すプロセスには、SE_LOAD_DRIVER_NAME特権が必要です。 システムまたは管理者コンテキストで実行されているプロセスは、SDK LookupPrivilegeValue 関数と AdjustTokenPrivileges 関数を使用して特権を昇格できます。 この詳細については、「 Bluetooth デバイスのインストール」を参照してください。
 
BLUETOOTH_LOCAL_SERVICE_INFO構造は、SDK BluetoothApis.h ヘッダー ファイルで定義されています。

要件

要件 値
サポートされている最小のクライアント バージョン:Windows Vista 以降の_Supported。
対象プラットフォーム ユニバーサル
Header bluetoothapis.h
Library BthProps.lib
[DLL] bthprops.cpl;BluetoothAPIs.dll

こちらもご覧ください

BLUETOOTH_LOCAL_SERVICE_INFO