Función CertSerializeCTLStoreElement (wincrypt.h)

  • Artículo

La función CertSerializeCTLStoreElement serializa un contexto de lista de confianza de certificado (CTL) codificado y la representación codificada de sus propiedades. El resultado se puede conservar en el almacenamiento para que las propiedades y CTL se puedan recuperar más adelante.

Sintaxis

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

Parámetros

[in] pCtlContext

Puntero a la estructura CTL_CONTEXT que se está serializando.

[in] dwFlags

Reservado para uso futuro y debe ser cero.

[out] pbElement

Puntero a un búfer que recibe la salida serializada, incluido el CTL 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 lista de confianza de certificados