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)

 LIBRARY
   Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)

 DESCRIPTION
   This function creates a set of certificate templates based on a
   set of input tuples. The tuples describe a set of authorizations
   for one or more subjects. The trust policy service provider maps
   these authorizations to appropriate template values for one or more
   certificates of the type managed by the Trust Policy module. The
   resulting certificate 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 these
   functions should carry the authorizations described in the input
   tuples.

 PARAMETERS
   TPHandle (input)
           The handle that describes the trust policy service module
           used to perform this function.

   CLHandle (input/optional)
           The handle that describes the certificate library module
           that can be used to assist in the creation of field values.
           If no certificate library module is specified, the TP module
           uses an assumed CL module, if required.

   TupleGroup (input)
           A pointer to a group of CSSM_TUPLE describing authorizations
           for one or more subjects.

   CertTemplates (output)
           A pointer to a structure containing references to one or
           more certificate templates resulting from the translation
           process.  Storage for the structure and certificate
           templates is allocated by the service provider and must be
           deallocated by the application.

 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.

        CSSMERR_TP_INVALID_CL_HANDLE
        CSSMERR_TP_INVALID_TUPLEGROUP_POINTER
        CSSMERR_TP_INVALID_TUPLEGROUP
        CSSMERR_TP_INVALID_TUPLE

 SEE ALSO
   Books

   Intel CDSA Application Developer's Guide (see CDSA)

   Other Help Topics

   For the CSSM API:

        CSSM_TP_CertGroupToTupleGroup
        CSSM_AC_AuthCompute

   For the TP SPI:

        TP_CertGroupToTupleGroup
        AC_AuthCompute