VMS Help  —  CDSA  CDSA_API, 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
Close Help