PWINBIO_LOCATE_SENSOR_CALLBACK função de retorno de chamada (winbio.h)

  • Artigo

Chamado pela Estrutura Biométrica do Windows para retornar resultados da função assíncrona WinBioLocateSensorWithCallback . O aplicativo cliente deve implementar essa função.

Importante Recomendamos que, começando com Windows 8, você não use mais a combinação PWINBIO_LOCATE_SENSOR_CALLBACK/WinBioLocateSensorWithCallback. Em vez disso, faça o seguinte:
  • Implemente uma função PWINBIO_ASYNC_COMPLETION_CALLBACK para receber aviso quando a operação for concluída.
  • Chame a função WinBioAsyncOpenSession . Passe o endereço do retorno de chamada no parâmetro CallbackRoutine . Passe WINBIO_ASYNC_NOTIFY_CALLBACK no parâmetro NotificationMethod . Recuperar um identificador de sessão assíncrona.
  • Use o identificador de sessão assíncrona para chamar WinBioLocateSensor. Quando a operação for concluída, a Estrutura Biométrica do Windows alocará e inicializará uma estrutura WINBIO_ASYNC_RESULT com os resultados e invocará o retorno de chamada com um ponteiro para a estrutura de resultados.
  • Chame WinBioFree de sua implementação de retorno de chamada para liberar a estrutura de WINBIO_ASYNC_RESULT depois de terminar de usá-la.
 

Sintaxe

PWINBIO_LOCATE_SENSOR_CALLBACK PwinbioLocateSensorCallback;

void PwinbioLocateSensorCallback(
  [in, optional] PVOID LocateCallbackContext,
  [in]           HRESULT OperationStatus,
                 WINBIO_UNIT_ID UnitId
)
{...}

Parâmetros

[in, optional] LocateCallbackContext

Ponteiro para um buffer definido pelo aplicativo e passado para o parâmetro LocateCallbackContext da função WinBioLocateSensorWithCallback . O buffer não é modificado pela estrutura ou pela unidade biométrica. Seu aplicativo pode usar os dados para ajudá-lo a determinar quais ações executar ou manter informações adicionais sobre a captura biométrica.

[in] OperationStatus

Código de erro retornado pela operação de captura.

UnitId

Número da ID da unidade biométrica.

Retornar valor

Nenhum

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbio.h