BluetoothSetServiceState 関数 (bluetoothapis.h)

[アーティクル]
02/23/2024

BluetoothSetServiceState 関数は、Bluetooth デバイスのサービスを有効または無効にします。

構文

DWORD BluetoothSetServiceState(
  HANDLE                      hRadio,
  const BLUETOOTH_DEVICE_INFO *pbtdi,
  const GUID                  *pGuidService,
  DWORD                       dwServiceFlags
);

パラメーター

hRadio

ローカル Bluetooth 無線のハンドル。

pbtdi

BLUETOOTH_DEVICE_INFO構造体へのポインター。以前に見つかった無線アドレスである必要があります。

pGuidService

リモートデバイス上のサービス GUID へのポインター。

dwServiceFlags

サービスを調整するフラグ。サービスを無効にするには、を BLUETOOTH_SERVICE_DISABLE に設定します。サービスを有効にするには、を BLUETOOTH_SERVICE_ENABLE に設定します。

戻り値

正常に完了 したときにERROR_SUCCESS を返します。次の表に、一般的なエラーの一覧を示します。

リターンコード	説明
ERROR_INVALID_PARAMETER	dwServiceFlags が無効です。
ERROR_SERVICE_DOES_NOT_EXIST	pGuidService で指定された GUID はサポートされていません。
E_INVALIDARG	dwServiceFlags が BLUETOOTH_SERVICE_DISABLE に設定されていて、サービスが既に無効になっているか、 dwServiceFlags が BLUETOOTH_SERVICE_ENABLE に設定され、サービスが既に有効になっています。

注釈

Windows では、Bluetooth 対応デバイスでサポートされているドライバーへのサービスグローバル一意識別子 (GUID) のマッピングが維持されています。サービスを有効にすると、対応するデバイスドライバーがインストールされ、サービスを無効にすると、対応するデバイスドライバーが削除されます。サポートされていないサービスが有効になっている場合、ドライバーはインストールされません。

要件

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