NAME

CSSM_CL_RegistrationFormSubmit

SYNOPSIS

CSSM_USER_AUTHENTICATION_PTR CSSMAPI
    CSSM_CL_RegistrationFormSubmit
    (CSSM_CL_Handle CLHandle,
    const CSSM_DATA_PTR RegistrationForm,
    const CSSM_NET_ADDRESS_ADDR RALocation,
    const CSSM_NET_ADDRESS_ADDR CALocation)

DESCRIPTION

The completed registration form is submitted to a Registration Authority requesting approval for certificate generation by a Certification Authority. An authentication credential is returned. This credential can be used as the input authentication credential in a certificate request call.

PARAMETERS

CLHandle (input)

A handle for the module that will perform the operation.

RegistrationForm (input)

A pointer to the CSSM_DATA structure containing the completed registration form to be submitted to the Registration Authority and Certification Authority.

RALocation (input/optional)

A pointer to a network address directly or indirectly identifying the location of the RA process. If the input is NULL, the module can assume a default RA process location. If a default cannot be assumed, the request cannot be initiated and the operation fails.

CALocation (input/optional)

A pointer to a network address directly or indirectly identifying the location of the CA process. If the input is NULL, the module or the Registration Authority can assume a default CA process location. If a default cannot be assumed, the request cannot be initiated and the operation fails.

RETURN VALUE

A pointer to a CSSM_USER_AUTHENTICATION credential. When NULL is returned, an error occurred or the registration form was rejected by the RA or the CA. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_CL_INVALID_CL_HANDLE

Invalid Certificate Library Handle.

CSSM_CL_INVALID_RA

Unknown or unreachable Registration Authority.

CSSM_CL_NO_DEFAULT_RA

No default Registration Authority.

CSSM_CL_RA_REJECTED_FORM

RA rejected the registration form.

CSSM_CL_CA_REJECTED_FORM

CA rejected the registration form.

CSSM_CL_MEMORY_ERROR

Error allocating memory.

CSSM_CL_FORM_SUBMIT_FAIL

Unable to submit the registration form.

SEE ALSO

CSSM_CL_RegistrationFormRequest