A pointer to the CSSM_GUID structure containingthe global unique identifier for this module.
Version (output)
The version number set on ModuleAttach.
SubServiceId (output)
The slot number of the reader to which the moduleis attached.
SubServiceType (output)
A CSSM_SERVICE_TYPE value identifying the classof security service.
AttachFlags (output)
This parameter provides the caller with sessionspecific information associated with the module handle.
KeyHierarchy (output)
The key hierarchy supplied when the module was attached.
AttachedMemFuncs (output)
The memory functions supplied when the module wasattached.
FunctionTable (input/output optional)
A table of function-name and API function-pointerpairs. The caller provides the name of the functions as input. Thecorresponding API function pointers are returned on output.
The function table allows dynamic linking of CDSA interfaces,including interfaces to Elective Module Managers, which are transparentlyloaded by CSSM during the CSSM_ModuleAttach() function. The caller of this function should allocatethe memory for the number of slots required.
NumFunctionTable (input)
The number of entries in the FunctionTable parameter.If no FunctionTable is provided, this value must be zero.
DESCRIPTIONThis function returns the state information associated withthe module handle. The information returned by this function isthat set by the call to the CSSM_ModuleAttach() function. The entry point to this function is providedto a service module in a table of upcall functions passed to theservice provider during module attach processing.
If the PVC checking for service providers is on, the serviceprovider has to introduce itself before calling this function.
RETURN VALUEA CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition. ERRORSErrors are described in the CDSA Technical Standard. SEE ALSOBooks