NAME    [Toc]    [Back]

       TP_FormRequest,   CSSM_TP_FormRequest   -  Get  form  from
       authority (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_TP_FormRequest (CSSM_TP_HANDLE
 TPHandle, const CSSM_TP_AUTHORITY_ID *PreferredAuthority,
 CSSM_TP_FORM_TYPE FormType, CSSM_DATA_PTR  BlankForm)
       SPI:  CSSM_RETURN  CSSMTPI  TP_FormRequest (CSSM_TP_HANDLE
       TPHandle, const CSSM_TP_AUTHORITY_ID  *PreferredAuthority,
       CSSM_TP_FORM_TYPE FormType, CSSM_DATA_PTR BlankForm)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The handle that describes the certification authority module
 used to perform this function.  A CSSM_TP_AUTHORITY_ID
       structure  containing either a certificate that identifies
       the Authority process, or a network  address  directly  or
       indirectly  identifying  the location of the authority. If
       the input is NULL, the module can assume a default authority
  location.  If a default authority can not be assumed,
       the request can not be initiated and the operation  fails.
       Indicates  the  type of form being requested.  A CSSM_DATA
       structure containing the requested form. The  caller  must
       have knowledge of the structure of the form based on FormType.

DESCRIPTION    [Toc]    [Back]

       This function returns a blank form of type  FormType  from
       an  Authority. If the PreferredAuthority list is NULL, the
       CA module can use a default authority  name  and  location
       based  on  FormType. The CA module must incorporate knowledge
 of the interface protocol for communicating with  the
       authority.

ERRORS    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).      CSSMERR_TP_INVALID_AUTHORITY      CSSMERR_TP_NO_DEFAULT_AUTHORITY
             CSSMERR_TP_UNSUPPORTED_ADDR_TYPE
   CSSMERR_TP_INVALID_NETWORK_ADDR    CSSMERR_TP_INVALID_FORM_TYPE

SEE ALSO    [Toc]    [Back]

       Books

       Intel    CDSA    Application    Developer's   Guide   (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions for the CSSM API:

       CSSM_TP_FormSubmit(3)

       Functions for the TP SPI:

       TP_FormSubmit(3)



                                                TP_FormRequest(3)