TElCertificateRevocationList.SaveToBufferPEM method

TElCertificateRevocationList.SaveToBufferPEM

Saves the certificate revocation list to the memory buffer in PEM format.

Declaration

[C#]
int SaveToBufferPEM(out byte[] Buffer, string Passphrase);
int SaveToBufferPEM(ref byte[] Buffer, ref int Size, string Passphrase);

[VB.NET]
Function SaveToBufferPEM(Out Buffer As Byte(), ByVal Passphrase As String) As Integer
Function SaveToBufferPEM(ByRef Buffer As Byte(), ByRef Size As Integer, ByVal Passphrase As String) As Integer

[Pascal]
function SaveToBufferPEM(Buffer: pointer; var Size: integer; const Passphrase: string = ''): integer;

[C++]
int32_t SaveToBufferPEM(void * Buffer, int32_t &Size, const std::string &Passphrase);

[PHP]
integer SaveToBufferPEM(TSBPointer|array of byte|string|NULL $Buffer, integer &$Size, string $Passphrase)

[Java]
    int saveToBufferPEM(byte[][] Buffer, String Passphrase);
    int saveToBufferPEM(byte[] Buffer, int[] Size, String Passphrase);
    int saveToBufferPEM(byte[] Buffer, TSBInteger Size, String Passphrase);

Parameters

Buffer - the buffer to which the CRL is saved.
Size - the size of the buffer to which the data is saved. When the method returns, Size parameter contains the size of the data that were saved, or, if the buffer was too small, the size of the buffer enough to hold the data.
Passphrase - the pass phrase to encrypt the CRL. If the CRL shouldn't be encrypted, set this parameter to empty string.
Cert - ...

Return value

0 if certificates were successfully saved.
SB_CRL error code otherwise.

CRL Error codes

[.NET] [Pascal] [C++]	Value	Description
SB_CRL_ERROR_INVALID_FORMAT	8705 (0x2201)	The format of the data buffer is not valid
SB_CRL_ERROR_BAD_SIGNATURE_ALGORITHM	8706 (0x2202)	The CRL is signed with unknown or unsupported algorithm
SB_CRL_ERROR_INVALID_ISSUER	8707 (0x2203)	The CRL was not signed with the specified certificate
SB_CRL_ERROR_INVALID_SIGNATURE	8708 (0x2204)	The signature is invalid. The CRL has been altered or broken.
SB_CRL_ERROR_UNSUPPORTED_VERSION	8709 (0x2205)	The CRL version is not supported by SecureBlackbox.
SB_CRL_ERROR_UNSUPPORTED_ALGORITHM	8710 (0x2206)	The algorithm, used to sign the CRL, was not recognized.
SB_CRL_ERROR_INVALID_CERTIFICATE	8711 (0x2207)	Certificate not specified or certificate algorithm doesn't correspond to CRL signature algorithm.
SB_CRL_ERROR_ALREADY_EXISTS	8712 (0x2208)	Not used.
SB_CRL_ERROR_NOT_FOUND	8713 (0x2209)	Not used.
SB_CRL_ERROR_PRIVATE_KEY_NOT_FOUND	8714 (0x220A)	Specified certificate doesn't have a private key, necessary to sign the CRL.
SB_CRL_ERROR_UNSUPPORTED_CERTIFICATE	8715 (0x220B)	The certificate utilizes unsupported public key algorithm.
SB_CRL_ERROR_INTERNAL_ERROR	8716 (0x220C)	Oops.
SB_CRL_ERROR_BUFFER_TOO_SMALL	8717 (0x220D)	Specified buffer is too small to save the CRL to.
SB_CRL_ERROR_NOTHING_TO_VERIFY	8718 (0x220E)	Nothing to verify.
SB_CRL_ERROR_NO_SIGNED_CRL_FOUND	8719 (0x220F)	A signed CRL has been received.

Description

This method saves the CRL to the provided memory location of the given size. If the buffer is too small (or empty), Size parameter is set to the size which will be enough to hold the whole data. The CRL is saved in PEM format.

Discuss this help topic in SecureBlackbox Forum