Função BluetoothSdpGetString (bluetoothapis.h)

Artigo
08/22/2023

A função BluetoothSdpGetString converte uma cadeia de caracteres bruta inserida no registro SDP em uma cadeia de caracteres Unicode.

Sintaxe

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

Um ponteiro para um fluxo de registro válido formatado como um único registro SDP.

[in] cbRecordLength

O comprimento, em bytes, de pRecordStream.

[in] pStringData

Quando definido como NULL, a localidade do thread de chamada é usada para pesquisar uma cadeia de caracteres correspondente no registro SDP. Se não for NULL, os membros mibeNum e attributeId da estrutura SDP_STRING_TYPE_DATA serão usados para localizar a cadeia de caracteres a ser convertida.

[in] usStringOffset

Deslocamento do tipo de cadeia de caracteres SDP a ser convertido. O usStringOffset é adicionado ao identificador de atributo base da cadeia de caracteres. Os deslocamentos definidos pela especificação do SDP são: STRING_NAME_OFFSET, STRING_DESCRIPTION_OFFSET e STRING_PROVIDER_NAME_OFFSET. Esses deslocamentos podem ser encontrados no arquivo de cabeçalho bthdef.h.

[out] pszString

Se não for NULL, conterá a cadeia de caracteres convertida na saída. Quando definido como NULL, o parâmetro pcchStringLength é preenchido com o número necessário de caracteres, não bytes, para recuperar a cadeia de caracteres convertida.

[in, out] pcchStringLength

Na entrada, contém o comprimento de pszString se pszString não for NULL, em caracteres.

Após a saída, contém o número de caracteres necessários, incluindo NULL , se um erro for retornado ou o número de caracteres gravados em pszString, incluindo NULL.

Retornar valor

Retorna ERROR_SUCCESS após a conclusão bem-sucedida; o parâmetro pszString contém a cadeia de caracteres convertida. Retorna códigos de erro após a falha. Erros comuns são listados na tabela a seguir.

Código de retorno	Descrição
ERROR_MORE_DATA	O parâmetro pszString era NULL ou muito pequeno para conter a cadeia de caracteres convertida; o parâmetro pcchStringLength contém, em caracteres, o comprimento necessário.
ERROR_INVALID_DATA	A conversão não pode ser executada.
ERROR_NO_SYSTEM_RESOURCES	O sistema não pode alocar memória internamente para executar a conversão.
ERROR_INVALID_PARAMETER	Um dos ponteiros necessários era NULL, o parâmetro pRecordStream não era um fluxo SDP válido, o pRecordStream não era um registro formatado corretamente ou o atributo solicitado mais deslocamento não era uma cadeia de caracteres.

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

Confira também

BluetoothSdpEnumAttributes

BluetoothSdpGetAttributeValue

BluetoothSdpGetContainerElementData

BluetoothSdpGetElementData

SDP_ELEMENT_DATA

SDP_STRING_TYPE_DATA

Compartilhar via