L_DicomGetSignedElementsCount

Summary

Returns the number of Data Elements covered by the specified Digital Signature.

Syntax

L_LTDIC_API L_UINT32 L_DicomGetSignedElementsCount(hDS, pSignatureItem)

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.

Returns

The number of Data Elements covered by the specified Digital Signature.

Comments

The Digital Signatures Sequence Item of a Digital Signature should reference an Item under the Message Authentication Code (MAC) Parameters Sequence associated with the Digital Signatures Sequence. The Data Elements Signed (0400,0020) under the referenced MAC Parameters Sequence Item specifies the signed Data Elements. You can use this function to obtain the number of Data Elements specified by this Data Element.

Along with this function, the L_DicomGetSignedElement function can be used to enumerate the Data Elements covered by the Digital Signature.

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

• L_DicomGetSignatureUID
• L_DicomGetSignatureDateTime
• L_DicomGetMacTransferSyntax
• L_DicomGetMacAlgorithm
• L_DicomSaveCertificate

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_DicomGetSignedElement
• L_DicomGetSignature
• L_DicomFindSignature
• L_DicomGetSignatureUID
• L_DicomGetSignatureDateTime
• L_DicomGetMacTransferSyntax
• L_DicomGetMacAlgorithm
• L_DicomSaveCertificate

Topics

• Working with Digital Signatures

Example

For an example, refer to L_DicomVerifySignature.