skip book previous and next navigation links
go up to top of book: HP Open Source Security for OpenVMS Volume 1:... HP Open Source Security for OpenVMS Volume 1:...
go to beginning of reference: API FunctionsAPI Functions
go to previous page: TP_SubmitCredRequestTP_SubmitCredRequest
go to next page: TerminateTerminate
end of book navigation links


TP_TupleGroupToCertGroup
Library
Parameters
Errors
 Description
Return Value
See Also

NAME

TP_TupleGroupToCertGroup: CSSM_TP_TupleGroupToCertGroup - Create a set of certificate templates (CDSA)

SYNOPSIS  

# include <cssm.h>

API:CSSM_RETURN CSSMAPI CSSM_TP_TupleGroupToCertGroup(CSSM_TP_HANDLE TPHandle,CSSM_CL_HANDLE  CLHandle,const CSSM_TUPLEGROUP *TupleGroup,CSSM_CERTGROUP_PTR *CertTemplates)SPI:CSSM_RETURN CSSMTPI TP_TupleGroupToCertGroup(CSSM_TP_HANDLE TPHandle,CSSM_CL_HANDLE  CLHandle,const CSSM_TUPLEGROUP *TupleGroup,CSSM_CERTGROUP_PTR *CertTemplates)


return to top LIBRARY  

Common Security Services Manager library (cdsa$incssm300_shr.exe)


return to top DESCRIPTION  

This function creates a set of certificate templates basedon a set of input tuples. The tuples describe a set of authorizationsfor one or more subjects. The trust policy service provider mapsthese authorizations to appropriate template values for one or morecertificates of the type managed by the Trust Policy module. The resultingcertificate templates can be input to a certificate creation function,such as CSSM_CL_CertSign(), (CSSM API), or CL_CertSign(), (TP SPI). The signed certificates created by thesefunctions should carry the authorizations described in the inputtuples.


return to top PARAMETERS  

TPHandle (input)
 The handle that describes the trust policy servicemodule used to perform this function.
CLHandle (input/optional)
 The handle that describes the certificate librarymodule that can be used to assist in the creation of field values.If no certificate library module is specified, the TP module usesan assumed CL module, if required.
TupleGroup (input)
 A pointer to a group of CSSM_TUPLE describing authorizationsfor one or more subjects.
CertTemplates (output)
 A pointer to a structure containing references toone or more certificate templates resulting from the translationprocess. Storage for the structure and certificate templates isallocated by the service provider and must be deallocated by theapplication.


return to top RETURN VALUE  

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.


return to top ERRORS  

Errors are described in the CDSA Technical Standard.
CSSMERR_TP_INVALID_CL_HANDLECSSMERR_TP_INVALID_TUPLEGROUP_POINTERCSSMERR_TP_INVALID_TUPLEGROUPCSSMERR_TP_INVALID_TUPLE


return to top SEE ALSO  

Books

Intel CDSA Application Developer's Guide

Online Help

For the CSSM API:

CSSM_TP_CertGroupToTupleGroup, CSSM_AC_AuthCompute

For the TP SPI:

TP_CertGroupToTupleGroup, AC_AuthCompute


go to previous page: TP_SubmitCredRequestTP_SubmitCredRequest
go to next page: TerminateTerminate