HP Open Source Security for OpenVMS Volume 1: Common Data Security Architecture > Human Recognition Service (HRS) API Functions

HRS_SetGUICallbacks

 » Table of Contents

 » Glossary

 » Index

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