HRS_Process

NAME

CSSM_HRS_Process, HRS_Process — Processes the intermediate data captured via a call to HRS_Capture for the purpose of either verification or identification

SYNOPSIS

#include <hrs.h>

API

CSSM_RETURN CSSMAPI CSSM_HRS_Process
        (CSSM_HRS_HANDLE ModuleHandle,
        const CSSM_HRS_INPUT_BIR *CapturedBIR,
        CSSM_HRS_BIR_HANDLE_PTR ProcessedBIR);

SPI

CSSM_RETURN CSSMHRI HRS_Process
        (CSSM_HRS_HANDLE ModuleHandle,
        const CSSM_HRS_INPUT_BIR *CapturedBIR,
        CSSM_HRS_BIR_HANDLE_PTR ProcessedBIR);

LIBRARY

HRS Extensible Module Manager (cdsa$inhrsemm_shr.exe)

PARAMETERS

The parameter definitions are the same for the API and the SPI.

`ModuleHandle` (input)		The handle of the attached HRS service provider.
`CapturedBIR` (input)		The captured BIR or its handle.
`ProcessedBIR` (output)		A handle for the newly constructed ‘‘processed’’ BIR, NULL.

DESCRIPTION

This function processes the intermediate data captured via a call to HRS_Capture() for the purpose of either verification or identification. If the processing capability is in the attached service provider, a “processed” BIR is returned; otherwise, ProcessedBIR is set to NULL.

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particular error condition. The value CSSM_OK indicates success. All other values represent an error condition.

ERRORS

Errors are described in the CDSA Technical Standard.

CSSMERR_CSSM_NOT_INITIALIZED CSSMERR_CSSM_FUNCTION_FAILED CSSMERR_CSSM_FUNCTION_NOT_IMPLEMENTED CSSMERR_CSSM_FUNCTION_INTEGRITY_FAIL CSSMERR_HRS_BIR_SIGNATURE_FAILURE CSSMERR_HRS_INCONSISTENT_PURPOSE CSSMERR_HRS_INVALID_BIR CSSMERR_HRS_PURPOSE_NOT_SUPPORTED CSSMERR_HRS_RECORD_NOT_FOUND CSSMERR_HRS_TOO_MANY_HANDLES CSSMERR_HRS_UNABLE_TO_WRAP_PAYLOAD