Fonction BluetoothSdpGetString (bluetoothapis.h)

Article
08/22/2023

La fonction BluetoothSdpGetString convertit une chaîne brute incorporée dans l’enregistrement SDP en chaîne Unicode.

Syntaxe

DWORD BluetoothSdpGetString(
  [in]      LPBYTE                      pRecordStream,
  [in]      ULONG                       cbRecordLength,
  [in]      const PSDP_STRING_TYPE_DATA pStringData,
  [in]      USHORT                      usStringOffset,
  [out]     PWSTR                       pszString,
  [in, out] PULONG                      pcchStringLength
);

Paramètres

[in] pRecordStream

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

[in] cbRecordLength

Longueur, en octets, de pRecordStream.

[in] pStringData

Lorsqu’il est défini sur NULL, les paramètres régionaux du thread appelant sont utilisés pour rechercher une chaîne correspondante dans l’enregistrement SDP. Si ce n’est pas NULL, les membres mibeNum et attributeId de la structure SDP_STRING_TYPE_DATA sont utilisés pour rechercher la chaîne à convertir.

[in] usStringOffset

Décalage de type de chaîne SDP à convertir. Le usStringOffset est ajouté à l’identificateur d’attribut de base de la chaîne. Les décalages définis par la spécification SDP sont les suivants : STRING_NAME_OFFSET, STRING_DESCRIPTION_OFFSET et STRING_PROVIDER_NAME_OFFSET. Ces décalages se trouvent dans le fichier d’en-tête bthdef.h.

[out] pszString

Si ce n’est pas NULL, contient la chaîne convertie sur la sortie. Lorsqu’il est défini sur NULL, le paramètre pcchStringLength est rempli avec le nombre requis de caractères, et non d’octets, pour récupérer la chaîne convertie.

[in, out] pcchStringLength

En entrée, contient la longueur de pszString si pszString n’a pas la valeur NULL, en caractères.

Lors de la sortie, contient le nombre de caractères requis, y compris NULL si une erreur est retournée, ou le nombre de caractères écrits dans pszString, y compris NULL.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite de l’exécution ; le paramètre pszString contient la chaîne convertie. Retourne les codes d’erreur en cas d’échec. Les erreurs courantes sont répertoriées dans le tableau suivant.

Code de retour	Description
ERROR_MORE_DATA	Le paramètre pszString était NULL ou trop petit pour contenir la chaîne convertie ; le paramètre pcchStringLength contient, en caractères, la longueur requise.
ERROR_INVALID_DATA	La conversion ne peut pas être effectuée.
ERROR_NO_SYSTEM_RESOURCES	Le système ne peut pas allouer de mémoire en interne pour effectuer la conversion.
ERROR_INVALID_PARAMETER	L’un des pointeurs requis était NULL, le paramètre pRecordStream n’était pas un flux SDP valide, le pRecordStream n’était pas un enregistrement correctement mis en forme ou l’attribut demandé plus le décalage n’était pas une chaîne.

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