NAME

CL_CertExport

SYNOPSIS

CSSM_DATA_PTR CSSMCLI CL_CertExport
    (CSSM_CL_HANDLE CLHandle,
    CSSM_CERT_TYPE TargetCertType,
    CSSM_CERT_ENCODING TargetCertEncoding,
    const CSSM_DATA_PTR NativeCert)

DESCRIPTION

This function exports a certificate from the native format of the specified certificate library into the specified target certificate format. The set of TargetCertTypes supported for export is at the discretion of the certificate library and is documented for each module as part of the CSSM_CLSUBSERVICE structure available from the CSSM Registry.

PARAMETERS

CLHandle (input)

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

TargetCertType (input)

A unique value that identifies the target type of the certificate being exported.

TargetCertEncoding (input)

A unique value that identifies the target encoding of the certificate being exported.

NativeCert (input)

A pointer to the CSSM_DATA structure containing the certificate to be exported.

RETURN VALUE

A pointer to the CSSM_DATA structure containing the target-type certificate exported from the native certificate. 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_INVALID_DATA_POINTER

Invalid pointer input.

CSSM_CL_UNKNOWN_FORMAT

Unrecognized certificate format.

CSSM_CL_MEMORY_ERROR

Not enough memory.

CSSM_CL_CERT_EXPORT_FAIL

Unable to export certificate.

SEE ALSO

CL_CertImport