PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN função de retorno de chamada (winbio_adapter.h)

Chamado pela Estrutura Biométrica do Windows para definir as políticas de antispoofing padrão e por usuário estendidas usadas pelo adaptador do mecanismo.

Sintaxe

PIBIO_ENGINE_SET_ACCOUNT_POLICY_FN PibioEngineSetAccountPolicyFn;

HRESULT PibioEngineSetAccountPolicyFn(
  [in, out] PWINBIO_PIPELINE Pipeline,
  [in]      PWINBIO_ACCOUNT_POLICY PolicyItemArray,
  [in]      SIZE_T PolicyItemCount
)
{...}

Parâmetros

[in, out] Pipeline

Ponteiro para a estrutura WINBIO_PIPELINE associada à unidade biométrica que executa a operação.

[in] PolicyItemArray

Endereço de uma matriz de estruturas WINBIO_ACCOUNT_POLICY , que a rotina deve usar para atualizar as políticas que está aplicando a todas as identidades detectadas.

[in] PolicyItemCount

O número de elementos na matriz apontada pelo parâmetro PolicyItemArray .

Retornar valor

Se a função for bem-sucedida, ela retornará S_OK. Se a função falhar, ela deverá retornar um dos seguintes valores HRESULT para indicar o erro.

Código de retorno	Descrição
E_some_error	Os erros retornados pelo método são registrados, mas ignorados.

Comentários

Esse método é chamado sempre que a unidade biométrica é ativada.

Esse método é executado no contexto do mesmo thread que ativou a unidade biométrica e que processou todas as outras solicitações para a unidade.

O campo Identity.Type do primeiro elemento no PolicyItemArray sempre será WINBIO_ID_TYPE_WILDCARD. Isso indica que o item de política contém um valor antispoofBehavior padrão que deve ser aplicado a qualquer conta de usuário que não esteja explicitamente listada no restante da matriz.

Se PolicyItemArray contiver mais de um elemento, o campo Identity.Type dos itens restantes será WINBIO_ID_TYPE_WILDCARD e o campo Identity.Value.AccountSid.Data conterá o SID de uma conta de usuário que requer o comportamento de política antispoof especificado no campo AntiSpoofBehavior do elemento array.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbio_adapter.h (inclua Winbio_adapter.h)