In This Topic ▼

L_DicomSaveCertificate

Summary

Saves the signers digital certificate associated with the specified Digital Signature to a file.

Syntax

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomSaveCertificate(hDS, pSignatureItem, pszFilename, uFormat)

Parameters

pDICOMELEMENT pSignatureItem

Pointer to a DICOMELEMENT structure that specifies the Digital Signatures Sequence Item which corresponds to the Digital Signature. This cannot be NULL.

const L_TCHAR * pszFilename

Character string that contains the name of the file to which the digital certificate should be saved. If the file already exists, it will be overwritten.

L_UINT16 uFormat

The format in which the digital certificate should be saved. Possible values are:

Value	Meaning
DICOM_CERTIFICATE_FORMAT_PEM	[0] Base-64 encoded X.509 Privacy Enhanced Mail (PEM).
DICOM_CERTIFICATE_FORMAT_DER	[1] Distinguished Encoding Rules (DER) encoded binary X.509.

Returns

Value	Meaning
DICOM_SUCCESS	The function was successful.
<> DICOM_SUCCESS	An error occurred. Refer to Return Codes.

Comments

The Certificate of Signer (0400,0115) under the Digital Signatures Sequence Item of a Digital Signature contains the digital certificate of the entity that produced the Digital Signature. You can use this function to save this digital certificate to a file.

The following functions can also be used to get information about the Digital Signature: