TP_TupleGroupToCertGroup

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