BluetoothSdpEnumAttributes 函式 (bluetoothapis.h)

發行項
02/28/2024

BluetoothSdpEnumAttributes 函式會透過 SDP 記錄數據流列舉，並針對記錄中的每個屬性呼叫回呼函式。

語法

BOOL BluetoothSdpEnumAttributes(
  LPBYTE                                 pSDPStream,
  ULONG                                  cbStreamSize,
  PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK pfnCallback,
  LPVOID                                 pvParam
);

參數

pSDPStream

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

cbStreamSize

pSDPStream 所指向的數據流大小，以位元組為單位。

pfnCallback

回呼例程的指標。如需回呼的詳細資訊，請參閱PFN_BLUETOOTH_ENUM_ATTRIBUTES_CALLBACK 。

pvParam

要傳遞至回呼例程的選擇性參數。

傳回值

如果發生列舉，則傳回 TRUE 。失敗時傳回 FALSE 。如需詳細資訊，請呼叫 GetLastError 函式。下表描述與 BluetoothSdpEnumAttributes 函式相關聯的常見錯誤碼：

傳回碼	Description
ERROR_INVALID_PARAMETER	pSDPStream 或 pfnCallback 參數為 NULL。
ERROR_INVALID_DATA	SDP 數據流已損毀。

備註

如果回呼函式傳回 FALSE， 則 BluetoothSdpEnumAttributes 函式所起始的列舉會停止。

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

規格需求

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