Windows Dev Center

Fechar a tabela de conteúdos
Expandir a tabela de conteúdos
Expand Minimize
Este conteúdo não está disponível no seu idioma mas aqui tem a versão em inglês.

CertSerializeCTLStoreElement function

The CertSerializeCTLStoreElement function serializes an encoded certificate trust list (CTL) context and the encoded representation of its properties. The result can be persisted to storage so that the CTL and properties can be retrieved later.


BOOL WINAPI CertSerializeCTLStoreElement(
  _In_    PCCTL_CONTEXT pCtlContext,
  _In_    DWORD         dwFlags,
  _Out_   BYTE          *pbElement,
  _Inout_ DWORD         *pcbElement


pCtlContext [in]

A pointer to the CTL_CONTEXT structure being serialized.

dwFlags [in]

Reserved for future use and must be zero.

pbElement [out]

A pointer to a buffer that receives the serialized output, including the encoded CTL 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.

pcbElement [in, out]

A pointer to a DWORD value that specifies the size, in bytes, of the buffer that is 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.


See Example C Program: Serializing Certificates.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]







See also

Certificate Trust List Functions



Conteúdo da Comunidade

© 2015 Microsoft