CertificateLoad (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / Certificate functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

CertificateLoad (Function)

In french: CertificatCharge

Loads a certificate from a file or from a buffer.

Example

// Load from a file
arrCertificate is array of Certificate
MyCertificate is Certificate

arrCertificate = CertificateLoad("MyCertificate.cer", "MyPassword")
MyCertificate = arrCertificate[1]

Syntax

Loading the certificate from a file Hide the details

<Result> = CertificateLoad(<Certificate file> , <Password>)

<Result>: Array of Certificates

Array of Certificate variables containing the loaded certificates.

<Certificate file>: Character string

Path of file containing the certificate to load.
This file can contain:
a PKCS#12 certificate of the "Public-Key Cryptography Standards" family. These files usually have a ".p12", ".cer" or ".crt" extension.
a certificate in PFX format (predecessor to the PKCS#12 format). These files usually have a ".pfx" extension.
Note: If the certificate path is not specified, the certificate will be searched for in the project library..

<Password>: Character string or Secret string

Certificate password.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "Ansi or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.

Loading the certificate from a buffer Hide the details

<Result> = CertificateLoad(<Buffer> , <Password>)

<Result>: Array of Certificates

Array of Certificate variables containing the loaded certificates.

<Buffer>: Buffer variable

Buffer containing the certificate data.

<Password>: Character string or Secret string

Certificate password.
New in version 2025
Secret strings: If you use the secret string vault, the type of secret string used for this parameter must be "Ansi or Unicode string".
To learn more about secret strings and how to use the vault, see Secret string vault.

Remarks

The certificate does not have to be found in the Windows store.

This function can be used to load the certificate used by SocketConnectSSL and NotifPushSend.

arrCertificate is array of Certificate
cerCertificatClient is Certificate
//------------------ Client certificate
tabCertificate = CertificateLoad("Certificat_client.p12", PASS_CERTIF)
IF ErrorDetected _OR_ tabCertificate.Occurrence < 1 THEN
	Error("No client certificate " + ErrorInfo(errMessage))
	RETURN
END
// Client certificate
cerCertificatClient = tabCertificat[tabCertificat.Occurence]

// It is possible to perform additional checks on the certificate
// by directly manipulating the cerCertificatClient variable

//------------------ Login
IF NOT SocketConnectedSSL(sConnectionName, nPortNumber, sServerAddress, 
		ProtocolTLS1_2 + ProtocolTLS1_3, 5 s,cerCertificatClient) THEN
	Error("Failed to connect to server [%sAdresseServeur%] on port [%nNumPort%]", 
			ErrorInfo())
	RETURN
END
Trace("Server found")
// Rest of code

The certificate can be included in the project library (WDL file).

Component: wd300std.dll