Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function serializes a certificate context's encoded certificate and its encoded properties. The result can be persisted to storage so that the certificate and properties can be retrieved at a later time.

Syntax 

BOOL WINAPI CertSerializeCertificateStoreElement(
  PCCERT_CONTEXT 
pCertContext,
  DWORD 
dwFlags,
  BYTE* 
pbElement,
  DWORD* 
pcbElement
);

Parameters

pCertContext

[in] Pointer to the CERT_CONTEXTstructure to be serialized.

dwFlags

[in] Reserved for future use and must be set to zero.

pbElement

[out] Pointer to a buffer that receives the serialized output, including the encoded certificate and possibly its properties.

This parameter can be NULL to set the size of this information for memory allocation purposes.

pcbElement

[in, out] On input, pointer to a DWORDvalue specifying the size, in bytes, of the buffer pointed to by pbElementr. On output, the DWORDvalue contains the number of bytes stored in the buffer.

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 the GetLastErrorfunction.

Requirements

Header wincrypt.h
Library crypt32.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also