NAME

CSSM_CL_RegistrationFormRequest

SYNOPSIS

CSSM_DATA_PTR CSSMAPI CSSM_CL_RegistrationFormRequest
    (CSSM_CL_HANDLE CLHandle,
    const CSSM_NET_ADDRESS_PTR RALocation)

DESCRIPTION

This function returns a blank registration form from a Registration Authority (RA) process. The RA process can be local or remote. The CL module incorporates knowledge of the name, location, and interface protocol for communicating with the RA.

PARAMETERS

CLHandle (input)

The handle that describes the add-in certificate library module used to perform this function.

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.

RETURN VALUE

A pointer to the CSSM_DATA structure containing the blank registration form. If the pointer is NULL, an error has occurred. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_CL_INVALID_CL_HANDLE

Invalid Certificate Library Handle.

CSSM_CL_UNABLE_TO_RETRIEVE_FORM

Unable to retrieve the registration form.

SEE ALSO

CSSM_CL_CertRequest