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)
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.
- 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.
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.
Invalid Certificate Library Handle.
Unknown or unreachable Registration Authority.
No default Registration Authority.
RA rejected the registration form.
CA rejected the registration form.
Error allocating memory.
Unable to submit the registration form.