Función BluetoothSdpGetAttributeValue (bluetoothapis.h)

Artículo
02/23/2024

La función BluetoothSdpGetAttributeValue recupera el valor de atributo de un identificador de atributo.

Sintaxis

DWORD BluetoothSdpGetAttributeValue(
  [in]  LPBYTE            pRecordStream,
  [in]  ULONG             cbRecordLength,
  [in]  USHORT            usAttributeId,
  [out] PSDP_ELEMENT_DATA pAttributeData
);

Parámetros

[in] pRecordStream

Puntero a una secuencia de registros válida que tiene el formato de un único registro SDP.

[in] cbRecordLength

Longitud de pRecordStream, en bytes.

[in] usAttributeId

Identificador de atributo que se va a buscar. Vea la sección Comentarios.

[out] pAttributeData

Puntero a una estructura SDP_ELEMENT_DATA en la que se coloca el valor de identificador del atributo.

Valor devuelto

Devuelve ERROR_SUCCESS tras la finalización correcta; El parámetro pAddributeData contiene el valor del atributo. Cualquier otro valor devuelto indica un error. En la tabla siguiente se describen los códigos de error comunes asociados a la función BluetoothSdpGetAttributeValue :

Código devuelto	Descripción
ERROR_INVALID_PARAMETER	Uno de los punteros necesarios era NULL, el parámetro pRecordStream no era una secuencia SDP válida o el parámetro pRecordStream no era un registro SDP con el formato correcto.
ERROR_FILE_NOT_FOUND	El identificador proporcionado en usAttributeId no se encontró en el registro.

Comentarios

La secuencia de registros de pRecordStream debe tener el formato de secuencia SDP como un registro SDP, una SECUENCIA que contenga el identificador de atributo (UINT16) más los pares de valor de atributo (cualquier tipo de elemento SDP).

El identificador de atributo proporcionado en el parámetro usAttributeId puede ser uno de los muchos identificadores de atributo universal SDP_ATTRIB_Xxx proporcionados en el archivo bthdef.h o un valor de atributo personalizado definido por un perfil de Bluetooth. Todos los valores mayores o iguales que 0x200 son identificadores de atributo específicos del perfil y son específicos del perfil. Consulte el archivo de encabezado bthdef.h para obtener una lista de identificadores de atributos SDP universales.

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 (incluye Bthsdpdef.h, BluetoothAPIs.h)
Library	Bthprops.lib
Archivo DLL	bthprops.cpl