Função CertSerializeCertificateStoreElement (wincrypt.h)

Artigo
03/03/2024

A função CertSerializeCertificateStoreElement serializa o certificado codificado de um contexto de certificado e suas propriedades codificadas. O resultado pode ser persistido no armazenamento para que o certificado e as propriedades possam ser recuperados posteriormente.

Sintaxe

BOOL CertSerializeCertificateStoreElement(
  [in]      PCCERT_CONTEXT pCertContext,
  [in]      DWORD          dwFlags,
  [out]     BYTE           *pbElement,
  [in, out] DWORD          *pcbElement
);

Parâmetros

[in] pCertContext

Um ponteiro para o CERT_CONTEXT a ser serializado.

[in] dwFlags

Reservado para uso futuro e deve ser zero.

[out] pbElement

Um ponteiro para um buffer que recebe a saída serializada, incluindo o certificado codificado 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 certificado

Compartilhar via