Función CertSerializeCertificateStoreElement (wincrypt.h)

Artículo
08/27/2023

La función CertSerializeCertificateStoreElement serializa el certificado codificado de un contexto de certificado y sus propiedades codificadas. El resultado se puede conservar en el almacenamiento para que el certificado y las propiedades se puedan recuperar más adelante.

Sintaxis

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

Parámetros

[in] pCertContext

Puntero al CERT_CONTEXT que se va a serializar.

[in] dwFlags

Reservado para uso futuro y debe ser cero.

[out] pbElement

Puntero a un búfer que recibe la salida serializada, incluido el certificado codificado y posiblemente sus propiedades.

Este parámetro puede ser NULL para establecer el tamaño de esta información con fines de asignación de memoria. Para obtener más información, vea Recuperar datos de longitud desconocida.

[in, out] pcbElement

Puntero a un valor DWORD que especifica el tamaño, en bytes, del búfer al que apunta el parámetro pbElement . Cuando la función devuelve, el valor DWORD contiene el número de bytes almacenados en el búfer.

Nota Al procesar los datos devueltos en el búfer, las aplicaciones deben usar el tamaño real de los datos devueltos. El tamaño real puede ser ligeramente menor que el tamaño del búfer especificado en la entrada. (En la entrada, los tamaños del búfer suelen especificarse lo suficientemente grandes como para asegurarse de que los datos de salida más grandes posibles se ajusten al búfer). En la salida, la variable a la que apunta este parámetro se actualiza para reflejar el tamaño real de los datos copiados en el búfer.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll

Consulte también

CertAddSerializedElementToStore

Funciones de certificado

Compartir a través de