Certificate (Variable type)

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

Properties specific to Certificate variables
WLanguage functions that use the Certificate type

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Certificate (Variable type)

In french: Certificat

The Certificate type is used to handle:

the certificates used to sign the strings or the files.
the certificates used to sign the emails. In this case, a Certificate variable is used by the Email variables.
the certificates used for the Push notifications sent to iOS applications.

You can define and change the characteristics of a certificate using different WLanguage properties.

Note: For more details on the declaration of this type of variable and the use of WLanguage properties, see Declaring a variable.

Example

MonCertificat is Certificate
// Ouverture du sélecteur de certificat de Windows
MonCertificat = CertificateSelect()
// Annulation ou erreur
IF MonCertificat.Name = "" THEN
	RETURN
END

Trace(MonCertificat.Issuer)
Trace(MonCertificat.StartValidityDate)
Trace(MonCertificat.EndValidityDate)
Trace(MonCertificat.Reliability)
Trace(MonCertificat.Name)
Trace(MonCertificat.SerialNumber)
Trace(MonCertificat.ValidForSignature)

Properties

Properties specific to Certificate variables

The following properties can be used to handle a certificate:


Property name	Type used	Effect
EndValidityDate	DateTime	End date and time of certificate validity. This property is read-only.
FullIssuer	Character string	Full name of certificate issuer. This property is read-only.
Issuer	Character string	Name of the certificate issuer ("Issued by" characteristic). This property is read-only.
KeyUsage	Integer constants	Expected uses for this certificate: certificateKeyEncipherment: Certificate used to encrypt a key. certificateDataEncipherment: Certificate used to encrypt data. certificateKeyExchange: Certificate used to exchange a key. certificateNonRepudiation: Certificate used for non-repudiation. certificateDigitalSignature: Certificate used for digital signatures. certificateSignKey: Certificate used to sign a key. This property is read-only.
Name	Character string	Name of the person to whom the certificate is given. This property is read-only.
OIDUsage	Array of strings	List of OIDs of the applications that use this certificate. This property is read-only.
Reliability	Integer constant	Trust level of the certificate corresponding to one of the following constants: certificateExpired: the certificate is expired. certificateInvalid: the certificate is invalid. certificateUntrusted: the certificate cannot be trusted. certificateOk: the certificate can be trusted. This property is read-only.
SerialNumber	Character string	Serial number of the certificate. This property is read-only.
StartValidityDate	DateTime	Start date and time of certificate validity. This property is read-only.
Subject	Character string	Text to identify the entity associated with the public key. For example, domain for which the certificate is issued and, depending on the type of certificate, information about the company that runs the site, validity period, etc. This property is read-only.
ThumbPrint	Character string	Unique number associated with the certificate. This number is automatically created when creating a certificate. This property is read-only.
ValidForSignature	Boolean	True if the certificate can be used to sign a document, False otherwise. CertificateSignFile and CertificateSignString will fail if this property is set to False. This property is used to find out whether the certificate owns a private key as well as all the characteristics required to perform a signature: be of type "SIGNATURE" (AT_SIGNATURE). be of type "KEY_EXCHANGE" (AT_KEYEXCHANGE). This property is read-only.

Remarks

WLanguage functions that use the Certificate type

The following functions use Certificate variables:

Standard functions:


New in version 2025 CertificateExport	Exports a certificate from a certificate store to a "pfx" or "cert" file.
CertificateExtract	Extracts a certificate from a signature buffer or from a print duplicate.
CertificateExtractExtensionValue	Returns the value of a certificate extension.
CertificateOpenProperties	Opens the Windows window used to find out the properties of a certificate.
CertificateSelect	Opens a window for selecting the certificates. The listed certificates are the certificates installed in the personal store.
CertificateSignExecutable	Signs an executable file with a certificate.
CertificateSignFile	Creates the signature of a file. This signature can be stored in a Buffer variable or in a text file.
CertificateSignString	Creates the signature of a character string.

Functions that use prefix syntax:
<Certificate variable>.OpenProperties Opens the Windows window used to find out the properties of a certificate.

See also

Minimum version required

Version 16

This page is also available for…

Comments

XADES-BES

Se puede firmar en formato XADES-BES ?

JAVIER / Javier

02 Dec. 2017

Exemplo pegar Dados Certificado

//Example catch certificate data
//Exemple certificat de capture de données

_certificado is Certificate
_certificado = CertificateSelect()

EDT_DadosDoCertificado="" // Limpando edt do certificado
EDT_DadosDoCertificado+="=====NOVOS WINDEV 21 ===============" //Novos Windev 21//new windev 21//
EDT_DadosDoCertificado+=CR+"Nome Completo Emissor [ "+_certificado.FullIssuer+" ] "
EDT_DadosDoCertificado+=CR+"Numero Associado ["+_certificado.Empreinte+" ]" // Em Frances // Em Ingles (Fingerprint)
EDT_DadosDoCertificado+=CR+"-Objeto [ "+_certificado.Objet+" ]" // Em Frances // Em Ingles ( object )
EDT_DadosDoCertificado+=CR+"===== Já tinha Windev 20 ==============="
EDT_DadosDoCertificado+=CR+"Nome Resumido [ "+_certificado.Name+" ]"
EDT_DadosDoCertificado+=CR+"Inicio Validade [ +_certificado.StartValidityDate+" ]"
EDT_DadosDoCertificado+=CR+"Final Validade [ "+_certificado.EndValidityDate+" ]"
EDT_DadosDoCertificado+=CR+"Issuer- Emissora [ "+_certificado.Issuer+" ]"
EDT_DadosDoCertificado+=CR+"Reliability-Confianca [ "+_certificado.Reliability+" ]"
EDT_DadosDoCertificado+=CR+"Serial Numero [ "+_certificado.SerialNumber+" ]"
EDT_DadosDoCertificado+=CR+"Certificado Valido [ "+_certificado.ValidForSignature+" ]"
EDT_DadosDoCertificado+=CR+"Subject [ "+_certificado.Subject+" ]"
EDT_DadosDoCertificado+=CR+"Thumprint - Impressão Digital [ "+_certificado.ThumbPrint+" ]"
EDT_DadosDoCertificado+=CR+"======================================"
//Blog com Video e Exemplo
http://windevdesenvolvimento.blogspot.com.br/2016/06/curso-windev-certificado-002.html
https://www.youtube.com/watch?v=XYWltoQ8u4Q

De matos AMARILDO

16 Jun. 2016

Last update: 09/19/2024

Send a report | Local help