cssm_GetAttachFunctions(3)cssm_GetAttachFunctions(3)NAMEcssm_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
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
This function returns an SPI function table for the service module
identified by the module handle. The module must be of the type speci‐
fied 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 repre‐
sent 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
cssm_GetAttachFunctions(3)