Collapse All Expand All

L_DicomDeleteSignature

#include "ltdic.h"

L_LTDIC_API L_VOID L_DicomDeleteSignature(hDS, pSignatureItem)

HDICOMDS hDS;	/* a DICOM handle */
pDICOMELEMENT pSignatureItem;	/* pointer to a Digital Signatures Sequence Item */

Removes one or all Digital Signatures from the Data Set.

Parameter	Description
hDS	A DICOM handle.
pSignatureItem	Pointer to a DICOMELEMENT structure that specifies the Digital Signatures Sequence Item which corresponds to the Digital Signature to be removed from the Data Set. To remove all the Digital Signatures in the entire Data Set, set this parameter to NULL.

Returns

None.

Comments

You can use this function to remove a single Digital Signature by specifying the corresponding Digital Signatures Sequence Item. The function will delete the specified Item from the Data Set. The Message Authentication Code (MAC) Parameters Sequence Item that was referenced by the deleted Digital Signatures Sequence Item will also be deleted if it is not referenced by a Digital Signatures Sequence Item anymore.

You can also use the function to remove all the Digital Signatures that exist in the Data Set by passing NULL to the function. In this case, all the MAC Parameters Sequence (4FFE,0001) and the Digital Signatures Sequence (FFFA,FFFA) Data Elements that exist in the Data Set will be deleted.

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_DicomVerifySignature, L_DicomCreateSignature
Topics:	Working with Digital Signatures

Example

For an example, refer to L_DicomFindSignature.