NAME
CSSM_HRS_SetGUICallbacks, HRS_SetGUICallbacks — Allows the application to establish callbacks so that
the application can control the ‘‘look-and-feel’’ of
the biometric user interface
SYNOPSIS
#include <hrs.h>
API
CSSM_RETURN CSSMAPI CSSM_HRS_SetGUICallbacks
(CSSM_HRS_HANDLE ModuleHandle,
CSSM_HRS_GUI_STREAMING_CALLBACK GuiStreamingCallback,
void *GuiStreamingCallbackCtx,
CSSM_HRS_GUI_STATE_CALLBACK GuiStateCallback,
void *GuiStateCallbackCtx); |
SPI
CSSM_RETURN CSSMHRI HRS_SetGUICallbacks
(CSSM_HRS_HANDLE ModuleHandle,
CSSM_HRS_GUI_STREAMING_CALLBACK GuiStreamingCallback,
void *GuiStreamingCallbackCtx,
CSSM_HRS_GUI_STATE_CALLBACK GuiStateCallback,
void *GuiStateCallbackCtx); |
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. |
| GuiStreamingCallback (input) | | A pointer to an application
callback to deal with the presentation of biometric streaming data. |
| GuiStreamingCallbackCtx (input) |
| | | A generic pointer to context
information provided by the application that will be presented on
the callback. |
| GuiStateCallback (input) | | A pointer to an application
callback to deal with GUI state changes. |
| GuiStateCallbackCtx (input) | | A generic pointer to context
information provided by the application that will be presented on
the callback. |
DESCRIPTION
This function allows the application to establish callbacks
so that the application can control the ‘‘look-and-feel’’ of
the biometric user interface. Note that not all HRS service providers
provide streaming data.
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
