In This Topic ▼

LDicomDS::GetSignature

Summary

Returns a pointer to the Digital Signatures Sequence Item that corresponds to the Digital Signature at the specified index.

Syntax

#include "ltdic.h"

pDICOMELEMENT LDicomDS::GetSignature(pItem, uIndex)

Parameters

pDICOMELEMENT pItem

Pointer to a DICOMELEMENT structure that specifies the Item in which the required Digital Signature is located. Set this parameter to NULL if the Digital Signature is located in the main Data Set.

L_UINT32 uIndex

The index of the required Digital Signature. This should be a number from 0 to LDicomDS::GetSignaturesCount(pItem) minus 1.

Returns

Value	Meaning
!NULL	Pointer to the DICOMELEMENT structure that specifies the Digital Signatures Sequence Item which corresponds to the required Digital Signature.
NULL	The specified index is invalid.

Comments

For each Digital Signature in the main Data Set or in an Item of a Sequence of Items, there should be a corresponding Item under the Digital Signatures Sequence (FFFA,FFFA) located in the main Data Set or in the Item. This function can be used to obtain a pointer to that Digital Signatures Sequence Item.

Along with this function, the function LDicomDS::GetSignaturesCount can be used to enumerate the Digital Signatures in the main Data Set or in an Item of a Sequence of Items. Once a pointer to the Digital Signatures Sequence Item is obtained, the following functions can be used to verify, delete, or get information about the Digital Signature:

LDicomDS::VerifySignature

LDicomDS::DeleteSignature

LDicomDS::GetSignatureUID

LDicomDS::GetSignatureDateTime

LDicomDS::GetSignedElementsCount

LDicomDS::GetSignedElement

LDicomDS::GetMacTransferSyntax

LDicomDS::GetMacAlgorithm

LDicomDS::SaveCertificate

You can also use the function LDicomDS::FindSignature to search the whole Data Set for a specific Digital Signature.

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

Example

L_INT LDicomDS_GetSignatureExample(LDicomDS& DataSet)  
{ 
   // We will enumerate the Digital Signatures in the main Data Set 
 
   L_UINT32 uSignaturesCount = DataSet.GetSignaturesCount(NULL);  
 
   if (uSignaturesCount == 0) 
   { 
      ::MessageBox(NULL, 
                   TEXT("No Digital Signatures in the main Data Set."), 
                   TEXT("Sample"), 
                   MB_OK); 
 
      return DICOM_SUCCESS; 
   } 
 
   L_TCHAR szMsg[128]; 
 
   if (uSignaturesCount == 1) 
   { 
      lstrcpy(szMsg, TEXT("There is 1 Digital Signature in the main Data Set. Do you want to examine it?"));  
   } 
   else 
   { 
      wsprintf(szMsg,  
               TEXT("There are %lu Digital Signatures in the main Data Set. Do you want to examine them?"), 
               uSignaturesCount);  
   } 
 
   if (::MessageBox(NULL, szMsg, TEXT("Sample"), MB_YESNO) != IDYES)  
   { 
      return DICOM_SUCCESS; 
   } 
 
   for (L_UINT32 i = 0; i < uSignaturesCount; i++) 
   { 
      // Refer to the example of LDicomDS::VerifySignature for the 
      // function ExamineSignature 
      ExamineSignature(DataSet, DataSet.GetSignature(NULL, i));  
   } 
 
   return DICOM_SUCCESS; 
}