Função BluetoothSdpGetAttributeValue (bluetoothapis.h)

Artigo
02/23/2024

A função BluetoothSdpGetAttributeValue recupera o valor do atributo para um identificador de atributo.

Sintaxe

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

Parâmetros

[in] pRecordStream

Ponteiro para um fluxo de registro válido que é formatado como um único registro SDP.

[in] cbRecordLength

Comprimento de pRecordStream, em bytes.

[in] usAttributeId

Identificador de atributo a ser pesquisado. Consulte Observações.

[out] pAttributeData

Ponteiro para uma estrutura SDP_ELEMENT_DATA na qual o valor do identificador do atributo é colocado.

Retornar valor

Retorna ERROR_SUCCESS após a conclusão bem-sucedida; o parâmetro pAddributeData contém o valor do atributo. Qualquer outro valor retornado indica erro. A tabela a seguir descreve códigos de erro comuns associados à função BluetoothSdpGetAttributeValue :

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	Um dos ponteiros necessários era NULL, o parâmetro pRecordStream não era um fluxo SDP válido ou o parâmetro pRecordStream não era um registro SDP formatado corretamente.
ERROR_FILE_NOT_FOUND	O identificador fornecido em usAttributeId não foi encontrado no registro.

Comentários

O fluxo de registro em pRecordStream deve ser um fluxo SDP formatado como um registro SDP, uma SEQUENCE contendo pares de ID de atributo (UINT16) mais valor de atributo (qualquer tipo de elemento SDP).

O identificador de atributo fornecido no parâmetro usAttributeId pode ser um dos muitos identificadores de atributo universal SDP_ATTRIB_Xxx fornecidos no arquivo bthdef.h ou um valor de atributo personalizado definido por um perfil Bluetooth. Todos os valores maiores ou iguais a 0x200 são identificadores de atributo específicos do perfil e são específicos para o perfil. Consulte o arquivo de cabeçalho bthdef.h para obter uma lista de identificadores de atributo SDP universais.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Nenhum compatível
Plataforma de Destino	Windows
Cabeçalho	bluetoothapis.h (inclua Bthsdpdef.h, BluetoothAPIs.h)
Biblioteca	Bthprops.lib
DLL	bthprops.cpl