TElCertificateRevocationList.SaveToBuffer method

TElCertificateRevocationList.SaveToBuffer

Saves the CRL to memory buffer.

Declaration

[C#]
int SaveToBuffer(out byte[] Buffer);
int SaveToBuffer(ref byte[] Buffer, ref int Size);

[VB.NET]
Function SaveToBuffer(Out Buffer As Byte()) As Integer
Function SaveToBuffer(ByRef Buffer As Byte(), ByRef Size As Integer) As Integer

[Pascal]
function SaveToBuffer(Buffer : pointer; var Size : integer) : integer;

[C++]
int32_t SaveToBuffer(void * Buffer, int32_t &Size);

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

[Java]
    int saveToBuffer(byte[] Buffer, int[] Size);
    int saveToBuffer(byte[][] Buffer);
    int saveToBuffer(byte[] Buffer, TSBInteger Size);

Parameters

Buffer - Buffer with certificate data
Size - Size of Buffer in bytes
Certificate - certificate to sign the CRL

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 DER format.
Use overloaded method without Certificate parameter to save only a *copy* of the loaded/generated CRL (without re-signing it).

Discuss this help topic in SecureBlackbox Forum