Funzione BluetoothSdpGetAttributeValue (bluetoothapis.h)

Articolo
02/23/2024

La funzione BluetoothSdpGetAttributeValue recupera il valore dell'attributo per un identificatore di attributo.

Sintassi

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

Parametri

[in] pRecordStream

Puntatore a un flusso di record valido formattato come singolo record SDP.

[in] cbRecordLength

Lunghezza di pRecordStream, in byte.

[in] usAttributeId

Identificatore di attributo da cercare. Vedere la sezione Osservazioni.

[out] pAttributeData

Puntatore a una struttura SDP_ELEMENT_DATA in cui viene inserito il valore dell'identificatore dell'attributo.

Valore restituito

Restituisce ERROR_SUCCESS al completamento positivo; il parametro pAddributeData contiene il valore dell'attributo. Qualsiasi altro valore restituito indica l'errore. La tabella seguente descrive i codici di errore comuni associati alla funzione BluetoothSdpGetAttributeValue :

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Uno dei puntatori necessari era NULL, il parametro pRecordStream non era un flusso SDP valido o il parametro pRecordStream non era un record SDP formattato correttamente.
ERROR_FILE_NOT_FOUND	L'identificatore fornito in usAttributeId non è stato trovato nel record.

Commenti

Il flusso di record in pRecordStream deve essere un flusso SDP formattato come record SDP, una sequenza contenente ID attributo (UINT16) e un valore di attributo (qualsiasi tipo di elemento SDP).

L'identificatore dell'attributo fornito nel parametro usAttributeId può essere uno dei molti identificatori di attributo universali SDP_ATTRIB_Xxx forniti nel file bthdef.h o un valore di attributo personalizzato definito da un profilo Bluetooth. Tutti i valori maggiori o uguali a 0x200 sono identificatori di attributo specifici del profilo e sono specifici del profilo. Per un elenco di identificatori di attributo SDP universali, vedere il file di intestazione bthdef.h.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	bluetoothapis.h (includere Bthsdpdef.h, BluetoothAPIs.h)
Libreria	Bthprops.lib
DLL	bthprops.cpl