Función CertCreateCTLEntryFromCertificateContextProperties (wincrypt.h)

  • Artículo

La función CertCreateCTLEntryFromCertificateContextProperties crea una entrada de lista de confianza de certificados (CTL) cuyos atributos son las propiedades del contexto del certificado. SubjectIdentifier en la entrada CTL es el hash SHA1 del certificado.

Las propiedades del certificado se agregan como atributos. El OID del atributo de propiedad es el PROP_ID decimal precedido por szOID_CERT_PROP_ID_PREFIX. Cada valor de propiedad se copia como un valor de atributo único.

Se pueden incluir atributos adicionales en la entrada CTL mediante los parámetros cOptAttr y rgOptAttr .

Sintaxis

BOOL CertCreateCTLEntryFromCertificateContextProperties(
  [in]      PCCERT_CONTEXT   pCertContext,
  [in]      DWORD            cOptAttr,
  [in]      PCRYPT_ATTRIBUTE rgOptAttr,
  [in]      DWORD            dwFlags,
  [in]      void             *pvReserved,
  [out]     PCTL_ENTRY       pCtlEntry,
  [in, out] DWORD            *pcbCtlEntry
);

Parámetros

[in] pCertContext

Puntero al CERT_CONTEXT usado para crear el CTL.

[in] cOptAttr

DWORD que especifica el número de atributos adicionales que se van a agregar.

[in] rgOptAttr

Puntero a cualquier matriz de atributos de CRYPT_ATTRIBUTE que se van a agregar al CTL.

[in] dwFlags

DWORD. Se puede establecer en CTL_ENTRY_FROM_PROP_CHAIN_FLAG para forzar la inclusión de las propiedades hash de creación de cadenas como atributos.

[in] pvReserved

Puntero a void. Reservado para uso futuro.

[out] pCtlEntry

Dirección de un puntero a una estructura CTL_ENTRY . Llame a esta función dos veces para recuperar una entrada de CTL. Establezca este parámetro en NULL en la primera llamada. Cuando se devuelve la función, use el número de bytes recuperados del parámetro pcbCtlEntry para asignar memoria. Vuelva a llamar a la función y establezca este parámetro en la dirección de la memoria asignada.

[in, out] pcbCtlEntry

Puntero a un DWORD que contiene el número de bytes que se deben asignar para la estructura CTL_ENTRY . Llame a esta función dos veces para recuperar el número de bytes. Para la primera llamada, establezca este parámetro en la dirección de un valor DWORD que contiene cero y establezca el parámetro pCtlEntry en NULL. Si la primera llamada se realiza correctamente, el valor DWORD contendrá el número de bytes que debe asignar para la estructura de CTL_ENTRY . Asigne la memoria necesaria y vuelva a llamar a la función, proporcionando la dirección de la memoria en el parámetro pCtlEntry .

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero (TRUE).

Si se produce un error en la función, devuelve cero (FALSE). Para obtener información de error extendida, llame a GetLastError.

Requisitos

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