Fonction BluetoothSdpGetAttributeValue (bluetoothapis.h)

Article
08/22/2023

La fonction BluetoothSdpGetAttributeValue récupère la valeur d’attribut d’un identificateur d’attribut.

Syntaxe

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

Paramètres

[in] pRecordStream

Pointeur vers un flux d’enregistrements valide mis en forme en tant qu’enregistrement SDP unique.

[in] cbRecordLength

Longueur de pRecordStream, en octets.

[in] usAttributeId

Identificateur d’attribut à rechercher. Consultez la section Notes.

[out] pAttributeData

Pointeur vers une structure SDP_ELEMENT_DATA dans laquelle la valeur d’identificateur de l’attribut est placée.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite de l’exécution ; le paramètre pAddributeData contient la valeur de l’attribut. Toute autre valeur de retour indique une erreur. Le tableau suivant décrit les codes d’erreur courants associés à la fonction BluetoothSdpGetAttributeValue :

Code de retour	Description
ERROR_INVALID_PARAMETER	L’un des pointeurs requis était NULL, le paramètre pRecordStream n’était pas un flux SDP valide ou le paramètre pRecordStream n’était pas un enregistrement SDP correctement mis en forme.
ERROR_FILE_NOT_FOUND	L’identificateur fourni dans usAttributeId n’a pas été trouvé dans l’enregistrement.

Remarques

Le flux d’enregistrements dans pRecordStream doit être un flux SDP mis en forme en tant qu’enregistrement SDP, une séquence contenant des paires ID d’attribut (UINT16) plus une valeur d’attribut (tout type d’élément SDP).

L’identificateur d’attribut fourni dans le paramètre usAttributeId peut être l’un des nombreux identificateurs d’attribut universels SDP_ATTRIB_Xxx fournis dans le fichier bthdef.h, ou une valeur d’attribut personnalisée définie par un profil Bluetooth. Toutes les valeurs supérieures ou égales à 0x200 sont des identificateurs d’attribut spécifiques au profil et sont spécifiques au profil. Consultez le fichier d’en-tête bthdef.h pour obtenir la liste des identificateurs d’attribut SDP universels.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	bluetoothapis.h (inclure Bthsdpdef.h, BluetoothAPIs.h)
Bibliothèque	Bthprops.lib
DLL	bthprops.cpl