Función BluetoothSdpGetString (bluetoothapis.h)

Artículo
02/26/2024

La función BluetoothSdpGetString convierte una cadena sin procesar incrustada en el registro SDP en una cadena Unicode.

Sintaxis

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

Parámetros

[in] pRecordStream

Puntero a una secuencia de registros válida con formato de registro único.

[in] cbRecordLength

Longitud, en bytes, de pRecordStream.

[in] pStringData

Cuando se establece en NULL, la configuración regional del subproceso que realiza la llamada se usa para buscar una cadena coincidente en el registro SDP. Si no es NULL, los miembros mibeNum y attributeId de la estructura SDP_STRING_TYPE_DATA se usan para buscar la cadena que se va a convertir.

[in] usStringOffset

Desplazamiento del tipo de cadena SDP que se va a convertir. UsStringOffset se agrega al identificador de atributo base de la cadena. Los desplazamientos definidos por la especificación SDP son: STRING_NAME_OFFSET, STRING_DESCRIPTION_OFFSET y STRING_PROVIDER_NAME_OFFSET. Estos desplazamientos se pueden encontrar en el archivo de encabezado bthdef.h.

[out] pszString

Si no es NULL, contiene la cadena convertida en la salida. Cuando se establece en NULL, el parámetro pcchStringLength se rellena con el número necesario de caracteres, no bytes, para recuperar la cadena convertida.

[in, out] pcchStringLength

En la entrada, contiene la longitud de pszString si pszString no es NULL, en caracteres.

Tras la salida, contiene el número de caracteres necesarios, incluido NULL si se devuelve un error, o el número de caracteres escritos en pszString, incluido NULL.

Valor devuelto

Devuelve ERROR_SUCCESS tras completarse correctamente; El parámetro pszString contiene la cadena convertida. Devuelve códigos de error tras un error. Los errores comunes se enumeran en la tabla siguiente.

Código devuelto	Descripción
ERROR_MORE_DATA	El parámetro pszString era NULL o demasiado pequeño para contener la cadena convertida; El parámetro pcchStringLength contiene, en caracteres, la longitud necesaria.
ERROR_INVALID_DATA	No se puede realizar la conversión.
ERROR_NO_SYSTEM_RESOURCES	El sistema no puede asignar memoria internamente para realizar la conversión.
ERROR_INVALID_PARAMETER	Uno de los punteros necesarios era NULL, el parámetro pRecordStream no era una secuencia SDP válida, pRecordStream no era un registro con formato correcto o el atributo solicitado más desplazamiento no era una cadena.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista, Windows XP con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	bluetoothapis.h (incluya Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
Archivo DLL	bthprops.cpl