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