cssm_GetAttachFunctions

NAME
  cssm_GetAttachFunctions - Get SPI function table (CDSA)

SYNOPSIS
  # include <cssm.h>

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

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

PARAMETERS
  hAddIn (input)
          The handle identifying the attach-session whose function
          table is to be returned by this function.

  AddinType (input)
          A CSSM_SERVICE_MASK value identifying the type of service
          module whose function table is to be returned by this
          function.

  SPFunctions (output)
          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.

  Guid (output)
          A CSSM_GUID value identifying the service module whose
          function table is to be returned by this function.

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