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

Functions:	LDicomDS::GetSignature, LDicomDS::FindSignature, LDicomDS::GetSignatureUID, LDicomDS::GetSignatureDateTime, LDicomDS::GetSignedElementsCount, LDicomDS::GetSignedElement, LDicomDS::GetMacTransferSyntax, LDicomDS::GetMacAlgorithm, Class Members
Topics:	Working with Digital Signatures
	How to Disable the Automatic Loading of the default DICOM IOD Table