LDicomDS::GetMacTransferSyntax

#include "ltdic.h"

L_CHAR* LDicomDS::GetMacTransferSyntax(pSignatureItem)

pDICOMELEMENT pSignatureItem;

/* pointer to a Digital Signatures Sequence Item */

Returns the Message Authentication Code (MAC) Calculation Transfer Syntax UID (0400,0010) used in the creation of the specified Digital Signature.

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.

Returns

The MAC Calculation Transfer Syntax UID (0400,0010) used in the creation of the specified Digital Signature. The return value can be NULL.

Comments

The Digital Signatures Sequence Item of a Digital Signature should reference an Item under the MAC Parameters Sequence associated with the Digital Signatures Sequence. The MAC Calculation Transfer Syntax UID (0400,0010) under the referenced MAC Parameters Sequence Item specifies the Transfer Syntax used in the calculation of the Message Authentication Code (MAC). The encrypted MAC is the digital signature itself. You can use this function to obtain the value of this Data Element.

If the Data Set was properly encoded, the return value will be a Transfer Syntax that explicitly includes the Value Representation (VR) and uses Little Endian encoding.

In addition to this function, the following functions can be used to get information about the Digital Signature:

LDicomDS::GetSignatureUID

LDicomDS::GetSignatureDateTime

LDicomDS::GetSignedElementsCount

LDicomDS::GetSignedElement

LDicomDS::GetMacAlgorithm

LDicomDS::SaveCertificate

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::GetMacAlgorithm, LDicomDS::SaveCertificate, Class Members

Topics:

Working with Digital Signatures

Example

For an example, refer to LDicomDS::VerifySignature.