NAME
CSSM_TP_FormRequest — Get form from authority (CDSA)
SYNOPSIS
# include <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 (cdsa$incssm300_shr.exe)
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.
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
Online Help
Functions for the CSSM API:
CSSM_TP_FormSubmit
Functions for the TP SPI:
TP_FormSubmit
