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 |
---|---|
|
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. |
|
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 |