HELPLIB.HLB  —  CDSA  CDSA_API, RefreshFunctionTable
 NAME
   RefreshFunctionTable - Gets EMM-defined API function (CDSA)

 SYNOPSIS
   # include <cssm.h>

        CSSM_RETURN CSSMAPI RefreshFunctionTable
        (CSSM_FUNC_NAME_ADDR_PTR FuncNameAddrPtr,
        uint32 NumOfFuncNameAddr)

 LIBRARY
   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 PARAMETERS
   FuncNameAddrPtr (input/output)
           A pointer to a table mapping function names to EMM-defined
           APIs.

   NumOfFuncNameAddr (input)
           The number of entries in the table referenced by
           FuncNameAddrPtr.

 DESCRIPTION
   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.

 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.

 SEE ALSO
   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics
Close Help