Função CertSerializeCTLStoreElement (wincrypt.h)

Artigo
03/13/2024

A função CertSerializeCTLStoreElement serializa um contexto de CTL (lista de certificados confiáveis) codificado e a representação codificada de suas propriedades. O resultado pode ser persistido no armazenamento para que a CTL e as propriedades possam ser recuperadas posteriormente.

Sintaxe

BOOL CertSerializeCTLStoreElement(
  [in]      PCCTL_CONTEXT pCtlContext,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbElement,
  [in, out] DWORD         *pcbElement
);

Parâmetros

[in] pCtlContext

Um ponteiro para a estrutura CTL_CONTEXT que está sendo serializada.

[in] dwFlags

Reservado para uso futuro e deve ser zero.

[out] pbElement

Um ponteiro para um buffer que recebe a saída serializada, incluindo a CTL codificada e, possivelmente, suas propriedades.

Esse parâmetro pode ser NULL para definir o tamanho dessas informações para fins de alocação de memória. Para obter mais informações, consulte Recuperando dados de comprimento desconhecido.

[in, out] pcbElement

Um ponteiro para um valor DWORD que especifica o tamanho, em bytes, do buffer apontado pelo parâmetro pbElement . Quando a função retorna o valor DWORD contém o número de bytes armazenados no buffer.

Nota Ao processar os dados retornados no buffer, os aplicativos devem usar o tamanho real dos dados retornados. O tamanho real pode ser ligeiramente menor do que o tamanho do buffer especificado na entrada. (Na entrada, os tamanhos de buffer geralmente são especificados grandes o suficiente para garantir que os maiores dados de saída possíveis caibam no buffer.) Na saída, a variável apontada por esse parâmetro é atualizada para refletir o tamanho real dos dados copiados para o buffer.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [aplicativos da área de trabalho \| aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll

Confira também

CertAddSerializedElementToStore

Funções de lista de confiança de certificado

Compartilhar via