Windows CE 3.0

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.

BOOL WINAPI CertSerializeCertificateStoreElement(
DWORD dwFlags,
BYTE *pbElement,
DWORD *pcbElement


[in] Pointer to the CERT_CONTEXT structure to be serialized.
[in] Reserved for future use and must be zero.
[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.

[in/out] Pointer to a DWORD value specifying the size, in bytes, of the buffer pointed to by pbElementr. 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 Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE.

For extended error information, call the GetLastError function.


Runs on Versions Defined in Include Link to
Windows CE OS 3.0 or later Wincrypt.h   Crypt32.lib
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

CertAddSerializedElementToStore, CERT_CONTEXT

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.