Función BluetoothSdpGetString (bluetoothapis.h)
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 |
|---|---|
|
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. |
|
No se puede realizar la conversión. |
|
El sistema no puede asignar memoria internamente para realizar la conversión. |
|
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 |