NAME
   CSSM_HRS_SetGUICallbacks, HRS_SetGUICallbacks

 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 may 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.  See CDSA.

   CSSMERR_CSSM_NOT_INITIALIZED
   CSSMERR_CSSM_FUNCTION_FAILED
   CSSMERR_CSSM_FUNCTION_NOT_IMPLEMENTED
   CSSMERR_CSSM_FUNCTION_INTEGRITY_FAIL