PIBIO_STORAGE_GET_RECORD_COUNT_FN fonction de rappel (winbio_adapter.h)
Appelé par l’infrastructure biométrique Windows ou par l’adaptateur du moteur pour récupérer le nombre d’enregistrements de modèle dans le jeu de résultats du pipeline.
Syntaxe
PIBIO_STORAGE_GET_RECORD_COUNT_FN PibioStorageGetRecordCountFn;
HRESULT PibioStorageGetRecordCountFn(
[in, out] PWINBIO_PIPELINE Pipeline,
[out] PSIZE_T RecordCount
)
{...}
Paramètres
[in, out] Pipeline
Pointeur vers une structure WINBIO_PIPELINE associée à l’unité biométrique qui effectue l’opération.
[out] RecordCount
Pointeur vers une variable qui reçoit le nombre d’enregistrements de modèle dans le jeu de résultats.
Valeur retournée
Si la fonction réussit, elle retourne S_OK. Si la fonction échoue, elle doit retourner l’une des valeurs HRESULT suivantes pour indiquer l’erreur.
Code de retour | Description |
---|---|
|
Un argument de pointeur obligatoire est NULL. |
|
La requête a réussi, mais aucun enregistrement correspondant n’a pu être trouvé. |
|
Le membre StorageContext de l’objet pipeline est NULL ou le membre FileHandle n’est pas valide. |
Remarques
Le nombre d’enregistrements actuellement dans le jeu de résultats est déterminé par l’appel le plus récent à la fonction StorageAdapterQueryByContent ou StorageAdapterQueryBySubject .
Exemples
Le pseudocode suivant montre une implémentation possible de cette fonction. L’exemple ne se compile pas. Vous devez l’adapter à votre objectif.
/////////////////////////////////////////////////////////////////////////////////////////
//
// StorageAdapterGetRecordCount
//
// Purpose:
// Retrieves the number of template records in the pipeline result set.
//
// Parameters:
// Pipeline - Pointer to a WINBIO_PIPELINE structure associated with
// the biometric unit performing the operation.
// RecordCount - Pointer to a variable that receives the number of template
// records in the result set.
//
static HRESULT
WINAPI
StorageAdapterGetRecordCount(
__inout PWINBIO_PIPELINE Pipeline,
__out PSIZE_T RecordCount
)
{
HRESULT hr = S_OK;
// Verify that pointer arguments are not NULL.
if (!ARGUMENT_PRESENT(Pipeline) ||
!ARGUMENT_PRESENT(RecordCount))
{
hr = E_POINTER;
goto cleanup;
}
// Retrieve the context from the pipeline.
PWINBIO_STORAGE_CONTEXT storageContext = (PWINBIO_STORAGE_CONTEXT)Pipeline->StorageContext;
// Verify the pipeline state.
if (storageContext == NULL || storageContext->FileHandle == INVALID_HANDLE_VALUE)
{
hr = WINBIO_E_INVALID_DEVICE_STATE;
goto cleanup;
}
// Call a custom function (_ResultSetGetCount) to retrieve the number of
// records that the most recent query left in the result set.
hr = _ResultSetGetCount( &storageContext->ResultSet, RecordCount);
cleanup:
return hr;
}
Configuration requise
Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | winbio_adapter.h (include Winbio_adapter.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour