NAME    [Toc]    [Back]

       cssm_GetAttachFunctions - Get SPI function table (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN   CSSMAPI  cssm_GetAttachFunctions  (CSSM_MODULE_HANDLE
  hAddIn,  CSSM_SERVICE_MASK   AddinType,   void
       **SPFunctions, CSSM_GUID_PTR Guid)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The  handle  identifying the attach-session whose function
       table is to be returned by  this  function.   A  CSSM_SERVICE_MASK
  value  identifying  the  type of service module
       whose function table is to be returned by  this  function.
       A pointer to the service module function table, which CSSM
       acquired from the service module during module-attach processing.
  The module manager should use this table to forward
 application invocation of the elective APIs to  their
       corresponding  SPIs. The memory pointed to by the function
       pointers should not be freed  by  the  EMM.   A  CSSM_GUID
       value  identifying the service module whose function table
       is to be returned by this function.

DESCRIPTION    [Toc]    [Back]

       This function returns an SPI function table for  the  service
  module  identified  by the module handle. The module
       must be of the type specified by  the  service  mask.  The
       SPFunctions   parameter  contains  the  returned  function
       table. The elective module manager must use this  function
       table  to  forward  an  application's call to the elective
       APIs to their corresponding SPIs represented in the  function
  table. The returned Guid identifies the service module.
 It can be used to locate credentials and other information
 about the service module.

       This  function  sets a lock on the SP functions table. The
       CSSM service function  cssm_ReleaseAttachFunctions()  must
       be used to release the lock.

RETURN VALUE    [Toc]    [Back]

       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    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).

SEE ALSO    [Toc]    [Back]

       Books

       Intel   CDSA   Application    Developer's    Guide    (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]




                                       cssm_GetAttachFunctions(3)