Compartir a través de

Función BluetoothRegisterForAuthenticationEx (bluetoothapis.h)

  • Artículo

La función BluetoothRegisterForAuthenticationEx registra una aplicación para una solicitud de pin, una comparación numérica y una función de devolución de llamada.

Nota Esta API se admite en Windows Vista SP2 y Windows 7.
 

Sintaxis

DWORD BluetoothRegisterForAuthenticationEx(
  [in, optional] const BLUETOOTH_DEVICE_INFO            *pbtdiIn,
  [out]          HBLUETOOTH_AUTHENTICATION_REGISTRATION *phRegHandleOut,
  [in, optional] PFN_AUTHENTICATION_CALLBACK_EX         pfnCallbackIn,
  [in, optional] PVOID                                  pvParam
);

Parámetros

[in, optional] pbtdiIn

Puntero a una estructura de BLUETOOTH_DEVICE_INFO que especifica la dirección bluetooth que se va a utilizar para la comparación.

[out] phRegHandleOut

Puntero a un identificador de HBLUETOOTH_AUTHENTICATION_REGISTRATION asociado a la aplicación registrada. Llame a BluetoothUnregisterAuthentication para cerrar el identificador.

[in, optional] pfnCallbackIn

Función a la que se llamará cuando se produzca el evento de autenticación. Esta función debe coincidir con el prototipo de PFN_AUTHENTICATION_CALLBACK_EX.

[in, optional] pvParam

Parámetro opcional que se va a pasar a la función de devolución de llamada especificada por pfnCallbackIn. Este parámetro puede ser cualquier cosa que se requiera para definir la aplicación.

Valor devuelto

Devuelve ERROR_SUCCESS tras completarse correctamente; devuelve los siguientes códigos de error tras un error:

Código devuelto Descripción
ERROR_OUTOFMEMORY
 Memoria insuficiente
Win32 Error
 El identificador de registro proporcionado no es válido.

Comentarios

El autor de la llamada debe proporcionar una dirección de devolución de llamada válida y debe anular el registro de la devolución de llamada una vez que la notificación ya no sea necesaria. La anulación del registro de un dispositivo autenticado se puede realizar mediante una llamada a BluetoothUnregisterAuthentication.

En escenarios en los que una aplicación se registra para la autenticación más de una vez, solo se llamará a la primera función de devolución de llamada registrada a través de esta función en la aplicación mientras la autenticación está en curso.

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

Consulte también

BluetoothRegisterForAuthentication

BluetoothUnregisterAuthentication