BluetoothSdpGetAttributeValue 函式 (bluetoothapis.h)

發行項
02/26/2024

BluetoothSdpGetAttributeValue 函式會擷取屬性標識符的屬性值。

語法

DWORD BluetoothSdpGetAttributeValue(
  [in]  LPBYTE            pRecordStream,
  [in]  ULONG             cbRecordLength,
  [in]  USHORT            usAttributeId,
  [out] PSDP_ELEMENT_DATA pAttributeData
);

參數

[in] pRecordStream

格式為單一 SDP 記錄的有效記錄數據流指標。

[in] cbRecordLength

pRecordStream 的長度，以位元組為單位。

[in] usAttributeId

要搜尋的屬性標識碼。請參閱＜備註＞。

[out] pAttributeData

放置屬性標識碼值的 SDP_ELEMENT_DATA 結構的指標。

傳回值

成功完成時傳回ERROR_SUCCESS; pAddributeData 參數包含屬性值。任何其他傳回值都表示錯誤。下表描述與 BluetoothSdpGetAttributeValue 函式相關聯的常見錯誤碼：

傳回碼	Description
ERROR_INVALID_PARAMETER	其中一個必要指標為 NULL、 pRecordStream 參數不是有效的 SDP 數據流，或 pRecordStream 參數不是正確格式化的 SDP 記錄。
ERROR_FILE_NOT_FOUND	在記錄中找不到 usAttributeId 中提供的標識碼。

備註

pRecordStream 中的記錄數據流必須是 SDP 數據流，格式為 SDP 記錄，而 SEQUENCE 包含屬性識別碼 (UINT16) 加上屬性值， (任何 SDP 元素類型) 組。

usAttributeId 參數中提供的屬性標識碼可以是 bthdef.h 檔案中提供的許多SDP_ATTRIB_Xxx通用屬性識別碼之一，或藍牙配置檔所定義的自定義屬性值之一。大於或等於0x200的所有值都是配置檔特定的屬性標識碼，而且是配置檔特有的值。如需通用 SDP 屬性識別碼的清單，請參閱 bthdef.h 頭檔。

規格需求

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