Função BluetoothRegisterForAuthenticationEx (bluetoothapis.h)

A função BluetoothRegisterForAuthenticationEx registra um aplicativo para uma solicitação de pin, comparação numérica e função de retorno de chamada.

Sintaxe

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

Um ponteiro para uma estrutura BLUETOOTH_DEVICE_INFO que especifica o endereço bluetooth a ser utilizado para comparação.

[out] phRegHandleOut

Um ponteiro para um identificador HBLUETOOTH_AUTHENTICATION_REGISTRATION associado ao aplicativo registrado. Chame BluetoothUnregisterAuthentication para fechar o identificador.

[in, optional] pfnCallbackIn

A função que será chamada quando o evento de autenticação ocorrer. Essa função deve corresponder ao protótipo de PFN_AUTHENTICATION_CALLBACK_EX.

[in, optional] pvParam

Parâmetro opcional a ser passado para a função de retorno de chamada especificada por pfnCallbackIn. Esse parâmetro pode ser qualquer coisa que o aplicativo seja necessário para definir.

Retornar valor

Retorna ERROR_SUCCESS após a conclusão bem-sucedida; retorna os seguintes códigos de erro após a falha:

Comentários

O chamador deve fornecer um endereço de retorno de chamada válido e deve cancelar o registro do retorno de chamada depois que a notificação não for mais necessária. O cancelamento do registro de um dispositivo autenticado pode ser feito chamando BluetoothUnregisterAuthentication.

Em cenários em que um aplicativo se registra para autenticação mais de uma vez, somente a primeira função de retorno de chamada registrada por meio dessa função será chamada no aplicativo enquanto a autenticação estiver em andamento.

Requisitos

Confira também

BluetoothRegisterForAuthentication

BluetoothUnregisterAuthentication