X509_CertSerialNumber

CryptoSys PKI Pro Manual

X509_CertSerialNumber

Returns the serial number of an X.509 certificate.

VBA/VB6 Syntax


Public Declare Function X509_CertSerialNumber Lib "diCrPKI.dll" 
    (ByVal strCertFile As String, ByVal strOutput As String, 
    ByVal nOutChars As Long, ByVal nOptions As Long) As Long

nRet = X509_CertSerialNumber(strCertFile, strOutput, nOutChars, nOptions)

C/C++ Syntax


long __stdcall X509_CertSerialNumber(const char *szCertFile, char *szOutput, long nOutChars, long nOptions);

Parameters

szCertFile: [in] with the filename of the X.509 certificate (or base64 representation).
szOutput: [out] to receive the serial number.
nOutChars: [in] specifying the maximum number of characters to be received.
nOptions: [in] option flags:
PKI_DEFAULT (0) for default output in hexadecimal format
PKI_X509_DECIMAL to output number in decimal format

Returns (VBA/C)

Returns the number of characters set in szOutput. If nOutChars is zero it returns the maximum number of characters required. C/C++ users should allocate one extra for the terminating NUL character. If an error occurs, it returns a negative error code.

.NET Equivalent

X509.CertSerialNumber Method

Remarks

The certificate may be in binary DER format or base64 PEM format.

Example

Dim nRet As Long
Dim strCertName As String
Dim strOutput As String * 64
 
strCertName = "BobRSASignByCarl.cer"	' Set dir to suit
nRet = X509_CertSerialNumber(strCertName, strOutput, Len(strOutput), 0)
Debug.Print "X509_CertSerialNumber returns " & nRet & " for " & strCertName & ": " & Left(strOutput, nRet)

Should result in

X509_CertSerialNumber returns 32 for BobRSASignByCarl.cer: 
46346bc7800056bc11d36e2ecd5d71d0

X509_CertSerialNumber

VBA/VB6 Syntax

C/C++ Syntax

Parameters

Returns (VBA/C)

.NET Equivalent

Remarks

Example

See Also