共用方式為

BluetoothSetLocalServiceInfo 函式 (bluetoothapis.h)

  • 發行項

BluetoothSetLocalServiceInfo 函式會設定特定藍牙無線電的本機服務資訊。

語法

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

參數

[in, optional] hRadioIn

用來指定本機服務資訊的藍牙無線電裝置句柄。 如果為 NULL，BluetoothSetLocalServiceInfo 會搜尋第一個可用的本機藍牙無線電。

[in] pClassGuid

要公開之服務的 GUID。 這應該符合伺服器端 INF 檔案中的 GUID 。

[in] ulInstance

隨插即用 (PnP) 識別碼之裝置節點的實例識別碼。

[in] pServiceInfoIn

描述要設定之本機服務的 BLUETOOTH_LOCAL_SERVICE_INFO 結構的指標。

傳回值

BluetoothSetLocalServiceInfo 函式會傳回下列值：

傳回碼 Description
ERROR_NOT_FOUND
 未偵測到指定的藍牙無線電。
ERROR_BAD_UNIT
 未偵測到藍牙無線電。
STATUS_INSUFFICIENT_RESOURCES
 沒有足夠的資源無法完成作業。 當 100 個以上的本機實體裝置物件 (PDO) 對應至藍牙服務時，您會收到此錯誤。
STATUS_PRIVILEGE_NOT_HELD
 呼叫端沒有必要的許可權。 如需如何提高許可權的相關信息，請參閱一節。

備註

BluetoothSetLocalServiceInfo 是使用者模式 API，僅供配置檔驅動程式開發人員用來觸發 pClassGuid 中服務 GUID 所描述的本機服務安裝。

BluetoothSetLocalServiceInfo 會以 “BTHENUM{ClassGuid}” 的形式產生 隨插即用 (PnP) 裝置標識符。 例如，“BTHENUM{xxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}”。 使用者模式應用程式可以使用相同的服務 GUID 呼叫 BluetoothSetLocalServiceInfo ，但使用不同的實例識別碼來建立指定伺服器端配置檔的多個實例。

若要使用藍牙 API，例如 BluetoothSetLocalServiceInfo，使用者模式應用程式應該與 BthProps.lib 連結。

警告 呼叫 BluetoothSetLocalServiceInfo 的程式必須具有 SE_LOAD_DRIVER_NAME 許可權。 在系統或系統管理員內容中執行的進程可以使用 SDK LookupPrivilegeValue 和 AdjustTokenPrivileges 函式來提升其許可權。 如需詳細資訊，請參閱 安裝藍牙裝置。
 
BLUETOOTH_LOCAL_SERVICE_INFO結構定義於 SDK BluetoothApis.h 頭檔中。

規格需求

需求 值
最低支援的用戶端 Windows Vista 和更新版本中的版本：_Supported。
目標平台 Universal
標頭 bluetoothapis.h
程式庫 BthProps.lib
Dll bthprops.cpl;BluetoothAPIs.dll

另請參閱

BLUETOOTH_LOCAL_SERVICE_INFO