Index for Section 3

Alphabetical listing for C

Bottom of page

cssm_GetAttachFunctions(3)
NAME
  cssm_GetAttachFunctions - Get SPI function table (CDSA)

SYNOPSIS
  # include <cdsa/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 (libcssm.so)

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_intro(3).

SEE ALSO
  Books

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

  Reference Pages

Index for Section 3

Alphabetical listing for C

Top of page