L_DicomSaveCertificate
#include "ltdic.h"
L_UINT16 EXT_FUNCTION L_DicomSaveCertificate(hDS, pSignatureItem, pszFilename, uFormat)
|
HDICOMDS hDS; |
/* a DICOM handle */ |
|
pDICOMELEMENT pSignatureItem; |
/* pointer to a Digital Signatures Sequence Item */ |
|
const L_CHAR * pszFilename; |
/* character string that contains the file name */ |
|
L_UINT16 uFormat; |
/* format */ |
Saves the signer’s digital certificate associated with the specified Digital Signature to a file.
|
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. This cannot be NULL. |
|
|
pszFilename |
Character string that contains the name of the file to which the digital certificate should be saved. If the file already exists, it will be overwritten. |
|
|
uFormat |
The format in which the digital certificate should be saved. Possible values are: |
|
|
|
Value |
Meaning |
|
|
DICOM_CERTIFICATE_FORMAT_PEM |
[0] Base-64 encoded X.509 Privacy Enhanced Mail (PEM). |
|
|
DICOM_CERTIFICATE_FORMAT_DER |
[1] Distinguished Encoding Rules (DER) encoded binary X.509. |
Returns
|
DICOM_SUCCESS |
The function was successful. |
|
<> DICOM_SUCCESS |
An error occurred. Refer to Return Codes. |
Comments
The Certificate of Signer (0400,0115) under the Digital Signatures Sequence Item of a Digital Signature contains the digital certificate of the entity that produced the Digital Signature. You can use this function to save this digital certificate to a file.
The following functions can also be used to get information about the 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 |
See Also
Example
For an example, refer to L_DicomVerifySignature.