L_DicomGetSignaturesCount

#include "ltdic.h"

L_UINT32 EXT_FUNCTION L_DicomGetSignaturesCount(hDS, pItem)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMELEMENT pItem;

/* pointer to an Item in a Sequence of Items */

Returns the number of Digital Signatures in the main Data Set or in an Item of a Sequence of Items.

Parameter

Description

hDS

A DICOM handle.

pItem

Pointer to a DICOMELEMENT structure that specifies an Item of a Sequence of Items in the Data Set. The function returns the number of Digital Signatures in this Item. If this parameter is set to NULL, the function returns the number of Digital Signatures in the main Data Set.

Returns

The number of Digital Signatures in the specified Item, or in the main Data Set if no Item is specified.

Comments

The function computes the number of Digital Signatures by counting the number of Items under the Digital Signatures Sequence (FFFA,FFFA) which is located under the Item specified by pItem or on the root of the Data Set if the parameter is set to NULL. The function returns 0 if this Sequence doesn’t exist.

One way of enumerating the Digital Signatures in the main Data Set or in an Item of a Sequence of Items is by using this function along with the L_DicomGetSignature function.

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:

L_DicomGetSignature, L_DicomFindSignature, L_DicomCreateSignature

Topics:

Working with Digital Signatures

Example

For an example, refer to L_DicomGetSignature.