Edit

Share via

CertSerializeCRLStoreElement function (wincrypt.h)

  • Article

The CertSerializeCRLStoreElement function serializes an encoded certificate revocation list (CRL) context and the encoded representation of its properties. The result can be persisted to storage so that the CRL and properties can be retrieved at a later time.

Syntax

BOOL CertSerializeCRLStoreElement(
  [in]      PCCRL_CONTEXT pCrlContext,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbElement,
  [in, out] DWORD         *pcbElement
);

Parameters

[in] pCrlContext

A pointer to the CRL_CONTEXT structure being serialized.

[in] dwFlags

Reserved for future use and must be zero.

[out] pbElement

A pointer to a buffer to receive the serialized output, including the encoded CRL, and possibly its properties.

This parameter can be NULL to set the size of this information for memory allocation purposes. For more information, see Retrieving Data of Unknown Length.

[in, out] pcbElement

A pointer to a DWORD value specifying the size, in bytes, of the buffer pointed to by the pbElement parameter. When the function returns, the DWORD value contains the number of bytes stored in the buffer.

Note  When processing the data returned in the buffer, applications must use the actual size of the data returned. The actual size can be slightly smaller than the size of the buffer specified on input. (On input, buffer sizes are usually specified large enough to ensure that the largest possible output data fits in the buffer.) On output, the variable pointed to by this parameter is updated to reflect the actual size of the data copied to the buffer.
 

Return value

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. For extended error information, call GetLastError.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps | UWP apps]
Minimum supported server Windows Server 2003 [desktop apps | UWP apps]
Target Platform Windows
Header wincrypt.h
Library Crypt32.lib
DLL Crypt32.dll

See also

CertAddSerializedElementToStore

Certificate Revocation List Functions