BluetoothEnumerateInstalledServices 函式 (bluetoothapis.h)

發行項
02/26/2024

BluetoothEnumerateInstalledServices 函式會列舉在藍牙裝置上啟用的全域唯一標識符) (服務 GUID。

語法

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

參數

hRadio

本機藍牙無線電裝置的句柄。如果 為 NULL，則會搜尋所有符合 pbtdi 中無線電位址的已啟用服務。

pbtdi

BLUETOOTH_DEVICE_INFO 結構的指標。

pcServiceInout

輸入時， pGuidServices 參數所指向的記錄數目。輸出時， pGuidServices 參數中傳回的有效記錄數目。如果 pGuidServices 為 NULL，則輸出 pcServices 包含已啟用的服務數目。

pGuidServices

記憶體中緩衝區的指標，以接收已安裝服務的 GUID。緩衝區至少必須是 *pcServices *sizeof (GUID) 位元組。

傳回值

在成功完成時傳回ERROR_SUCCESS，而 pGuidServices 參數包含已啟用服務 GUID 的完整清單。

下表描述常見的錯誤：

傳回碼	Description
ERROR_MORE_DATA	呼叫成功。 pGuidServices 參數包含未完成的已啟用服務 GUID 清單。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	bluetoothapis.h (包括 Bthsdpdef.h、BluetoothAPIs.h)
程式庫	Bthprops.lib
Dll	bthprops.cpl