|
RefreshFunctionTable(3)
Contents |
RefreshFunctionTable - Gets EMM-defined API function
(CDSA)
# include <cdsa/cssm.h>
CSSM_RETURN CSSMAPI RefreshFunctionTable
(CSSM_FUNC_NAME_ADDR_PTR FuncNameAddrPtr, uint32 NumOfFuncNameAddr)
Common Security Services Manager library (libcssm.so)
A pointer to a table mapping function names to EMM-defined
APIs. The number of entries in the table referenced by
FuncNameAddrPtr.
CSSM invokes this function to obtain the EMM-defined API
function. The table is returned to CSSM in FuncNameAddrPtr
and CSSM returns the table to the application. The application
uses this table to invoke the security services
defined by the EMM's service category. CSSM must obtain
and forward the API table to the application on behalf of
the EMM because the application is not aware of the
optional nature of the EMM. Applications use CSSM to
obtain the API function table for basic module managers
and elective module managers, providing a uniform application
programming model.
If the Elective Module Manager needs the service
provider's SPI function table in order to initialize the
API function table, the EMM can obtain the SPI function
table by invoking the CSSM-provided service cssm_GetAttachFunctions().
The service module may implement only a
subset of the defined functions and the EMM may wish to
manage these functions in a particular manner through the
API mapping. The elective module manager uses the SPI
function table to dispatch application calls for service
to attached modules.
Multiple applications and multiple instances of a service
module can be concurrently active. The single elective
module manager is responsible for managing all of these
concurrent sessions. After completing initialization of
the API function table, the EMM returns the refreshed API
table to CSSM.
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 are described in the CDSA technical standard. See
CDSA_intro(3).
Books
Intel CDSA Application Developer's Guide (see
CDSA_intro(3))
Reference Pages [Toc] [Back]
RefreshFunctionTable(3)
[ Back ] |