LDicomNet::SetClientCertificateTLS

#include "ltdic.h"

L_UINT32 LDicomNet::SetClientCertificateTLS(pszPathToCertificateFile, nCertType, pszPathToKeyFile);

L_CHAR *pszPathToCertificateFile;	/* character string */
L_UINT32 nCertType;	/* certificate type */
L_CHAR *pszPathToKeyFile;	/* character string */

Sets a certificate for the client. This function is available in the Medical Suite toolkits.

Parameter	Description
pszPathToCertificateFile	Character string that contains the path to the file that contains the certificate.
nCertType	Flag that indicates whether the certificate is binary or text. Possible values are:
	Value	Meaning
	L_TLS_FILETYPE_PEM	Text certificate
	L_TLS_FILETYPE_ASN1	Binary certificate
pszPathToKeyFile	Character string that contains the path to the file containing the private key. This parameter is used if the private key is available in raw mode.

Returns

DICOM_SUCCESS	Success
<>DICOM_SUCCESS	An error occurred. Refer to Return Codes.

Comments

The usual sizes for an RSA key is 512 and 1024 bits. There is a limitation for import in Europe – a RSA key must be at least 768 bits long. There are no known export restrictions.

Required DLLs and Libraries

LTDIC
LTCRY
LTTLS

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:	LDicomNet::SetServerCertificateTLS, Class Members
Topics:	Adding TLS Security to a DICOM Connection
	Negotiating a Ciphersuite
	General Transport Layer Secure (TLS) Information

Example

{
   LDicomNet *pDicomNet;
   int nRet;
   nRet = pDicomNet->SetClientCertificateTLS("c:\\cert\\client.pem", L_TLS_FILETYPE_PEM, NULL);
   char strMsg[64];
   sprintf(strMsg, "Loaded client certificate, result is %s", nRet?"Error":"Success");
   AfxMessageBox(strMsg);
}