Compartir a través de

Función BluetoothSetLocalServiceInfo (bluetoothapis.h)

  • Artículo

La función BluetoothSetLocalServiceInfo establece información de servicio local para una radio Bluetooth específica.

Sintaxis

DWORD BluetoothSetLocalServiceInfo(
  [in, optional] HANDLE                             hRadioIn,
  [in]           const GUID                         *pClassGuid,
  [in]           ULONG                              ulInstance,
  [in]           const BLUETOOTH_LOCAL_SERVICE_INFO *pServiceInfoIn
);

Parámetros

[in, optional] hRadioIn

Identificador del dispositivo de radio Bluetooth para especificar la información del servicio local. Si es NULL, BluetoothSetLocalServiceInfo busca la primera radio Bluetooth local disponible.

[in] pClassGuid

GUID del servicio que se va a exponer. Esto debe coincidir con el GUID en el archivo INF del lado servidor.

[in] ulInstance

Identificador de instancia del nodo de dispositivo del identificador de Plug and Play (PnP).

[in] pServiceInfoIn

Puntero a una estructura de BLUETOOTH_LOCAL_SERVICE_INFO que describe el servicio local que se va a establecer.

Valor devuelto

La función BluetoothSetLocalServiceInfo devuelve los valores siguientes:

Código devuelto Descripción
ERROR_NOT_FOUND
 No se detectó la radio Bluetooth especificada.
ERROR_BAD_UNIT
 No se detectaron radios Bluetooth.
STATUS_INSUFFICIENT_RESOURCES
 No había suficientes recursos disponibles para completar la operación. Puede recibir este error cuando más de 100 objetos de dispositivo físico local (PDA) se correspondan con los servicios Bluetooth.
STATUS_PRIVILEGE_NOT_HELD
 El autor de la llamada no tiene los privilegios necesarios. Consulte la sección Comentarios para obtener información sobre cómo elevar privilegios.

Comentarios

BluetoothSetLocalServiceInfo es una API en modo de usuario que solo usan los desarrolladores de controladores de perfiles para desencadenar la instalación de un servicio local descrito por el GUID de servicio en pClassGuid.

BluetoothSetLocalServiceInfo genera un identificador de dispositivo de Plug and Play (PnP) en forma de "BTHENUM{ClassGuid}". Por ejemplo, "BTHENUM{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}". Las aplicaciones en modo de usuario pueden llamar a BluetoothSetLocalServiceInfo las horas posteriores con el mismo GUID de servicio, pero con un identificador de instancia diferente para crear varias instancias del perfil del lado servidor especificado.

Para usar las API de Bluetooth como BluetoothSetLocalServiceInfo, las aplicaciones en modo de usuario deben vincularse con BthProps.lib.

Advertencia El proceso que llama a BluetoothSetLocalServiceInfo debe tener el privilegio SE_LOAD_DRIVER_NAME . Un proceso que se ejecuta en el sistema o en un contexto de administrador puede elevar sus privilegios mediante las funciones LookupPrivilegeValue y AdjustTokenPrivileges del SDK. Para obtener más información, consulte Instalación de un dispositivo Bluetooth.
 
La estructura BLUETOOTH_LOCAL_SERVICE_INFO se define en el archivo de encabezado BluetoothApis.h del SDK.

Requisitos

Requisito Value
Cliente mínimo compatible Versions:_Supported en Windows Vista y versiones posteriores.
Plataforma de destino Universal
Encabezado bluetoothapis.h
Library BthProps.lib
Archivo DLL bthprops.cpl; BluetoothAPIs.dll

Consulte también

BLUETOOTH_LOCAL_SERVICE_INFO