Index for Section 3

Alphabetical listing for T

Bottom of page

TP_FormRequest(3)
NAME
  TP_FormRequest, CSSM_TP_FormRequest - Get form from authority (CDSA)

SYNOPSIS
  # 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
  Common Security Services Manager library (libcssm.so)

PARAMETERS
  TPHandle (input)
	  The handle that describes the certification authority module used
	  to perform this function.

  PreferredAuthority (input/optional)
	  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.

  FormType (input)
	  Indicates the type of form being requested.

  BlankForm (output)
	  A CSSM_DATA structure containing the requested form. The caller
	  must have knowledge of the structure of the form based on FormType.

DESCRIPTION
  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
  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
  Books

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

  Reference Pages

  Functions for the CSSM API:

  CSSM_TP_FormSubmit(3)

  Functions for the TP SPI:

  TP_FormSubmit(3)

Index for Section 3

Alphabetical listing for T

Top of page