L_DicomSaveCertificate

Summary

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

Syntax

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

Parameters

HDICOMDS hDS

A DICOM handle.

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:

Returns

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:

• L_DicomGetSignatureUID
• L_DicomGetSignatureDateTime
• L_DicomGetSignedElementsCount
• L_DicomGetSignedElement
• L_DicomGetMacTransferSyntax
• L_DicomGetMacAlgorithm

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

Platforms

Win32, x64

See Also

Functions

• L_DicomGetSignature
• L_DicomFindSignature
• L_DicomGetSignatureUID
• L_DicomGetSignatureDateTime
• L_DicomGetSignedElementsCount
• L_DicomGetSignedElement
• L_DicomGetMacTransferSyntax
• L_DicomGetMacAlgorithm

Topics

• Working with Digital Signatures

Example

For an example, refer to L_DicomVerifySignature.