LDicomDS::SaveCertificate

#include "ltdic.h"

L_UINT16 LDicomDS::SaveCertificate(pSignatureItem, pszFilename, uFormat = DICOM_CERTIFICATE_FORMAT_PEM)

pDICOMELEMENT pSignatureItem;

/* pointer to a Digital Signatures Sequence Item */

const L_TCHAR* pszFilename;

/* character string that contains the file name */

L_UINT16 uFormat;

/* format */

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

Parameter

Description

pSignatureItem

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

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.

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

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:

LDicomDS::GetSignatureUID

LDicomDS::GetSignatureDateTime

LDicomDS::GetSignedElementsCount

LDicomDS::GetSignedElement

LDicomDS::GetMacTransferSyntax

LDicomDS::GetMacAlgorithm

Required DLLs and Libraries

LTDIC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

LDicomDS::GetSignature, LDicomDS::FindSignature, LDicomDS::GetSignatureUID, LDicomDS::GetSignatureDateTime, LDicomDS::GetSignedElementsCount, LDicomDS::GetSignedElement, LDicomDS::GetMacTransferSyntax, LDicomDS::GetMacAlgorithm, Class Members

Topics:

Working with Digital Signatures

Example

For an example, refer to LDicomDS::VerifySignature.