Partager via


Fonction BluetoothSdpGetAttributeValue (bluetoothapis.h)

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

Voir aussi

BluetoothSdpEnumAttributes

BluetoothSdpGetContainerElementData

BluetoothSdpGetElementData

BluetoothSdpGetString

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA