Funzione BluetoothSdpGetString (bluetoothapis.h)

Articolo
08/22/2023

La funzione BluetoothSdpGetString converte una stringa non elaborata incorporata nel record SDP in una stringa Unicode.

Sintassi

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
);

Parametri

[in] pRecordStream

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

[in] cbRecordLength

Lunghezza, in byte, di pRecordStream.

[in] pStringData

Se impostato su NULL, le impostazioni locali del thread chiamante vengono usate per cercare una stringa corrispondente nel record SDP. In caso contrario , i membri mibeNum e attributeId della struttura SDP_STRING_TYPE_DATA vengono usati per trovare la stringa da convertire.

[in] usStringOffset

Offset del tipo di stringa SDP da convertire. L'oggetto usStringOffset viene aggiunto all'identificatore dell'attributo di base della stringa. Gli offset definiti dalla specifica SDP sono: STRING_NAME_OFFSET, STRING_DESCRIPTION_OFFSET e STRING_PROVIDER_NAME_OFFSET. Questi offset sono disponibili nel file di intestazione bthdef.h.

[out] pszString

In caso contrario, contiene la stringa convertita nell'output. Se impostato su NULL, il parametro pcchStringLength viene riempito con il numero necessario di caratteri, non byte, per recuperare la stringa convertita.

[in, out] pcchStringLength

In input, contiene la lunghezza di pszString se pszString non è NULL, in caratteri.

Al termine dell'output, contiene il numero di caratteri necessari, inclusi NULL , se viene restituito un errore o il numero di caratteri scritti in pszString, incluso NULL.

Valore restituito

Restituisce ERROR_SUCCESS al completamento positivo; il parametro pszString contiene la stringa convertita. Restituisce i codici di errore in caso di errore. Gli errori comuni sono elencati nella tabella seguente.

Codice restituito	Descrizione
ERROR_MORE_DATA	Il parametro pszString era NULL o troppo piccolo per contenere la stringa convertita; il parametro pcchStringLength contiene, in caratteri, la lunghezza necessaria.
ERROR_INVALID_DATA	Impossibile eseguire la conversione.
ERROR_NO_SYSTEM_RESOURCES	Il sistema non può allocare la memoria internamente per eseguire la conversione.
ERROR_INVALID_PARAMETER	Uno dei puntatori necessari era NULL, il parametro pRecordStream non era un flusso SDP valido, il valore pRecordStream non era un record formattato correttamente o l'attributo richiesto più offset non era una stringa.

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

Vedi anche

BluetoothSdpEnumAttributes

BluetoothSdpGetAttributeValue

BluetoothSdpGetContainerElementData

BluetoothSdpGetElementData

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA