Función CertFindSubjectInSortedCTL (wincrypt.h)

  • Artículo

La función CertFindSubjectInSortedCTL intenta buscar el asunto especificado en una lista de confianza de certificado ordenado (CTL). Un sujeto se puede identificar por el contexto completo del certificado o por cualquier identificador único del firmante del certificado, como el hash SHA1 del emisor y el número de serie del certificado.

Sintaxis

BOOL CertFindSubjectInSortedCTL(
  [in]  PCRYPT_DATA_BLOB pSubjectIdentifier,
  [in]  PCCTL_CONTEXT    pCtlContext,
  [in]  DWORD            dwFlags,
  [in]  void             *pvReserved,
  [out] PCRYPT_DER_BLOB  pEncodedAttributes
);

Parámetros

[in] pSubjectIdentifier

Puntero a una estructura CRYPT_DATA_BLOB que identifica de forma única el asunto. La información de esta estructura puede ser un hash o cualquier secuencia de bytes única.

[in] pCtlContext

Puntero a la estructura CTL_CONTEXT que se va a buscar.

[in] dwFlags

Reservado para uso futuro y debe ser NULL.

[in] pvReserved

Reservado para uso futuro y debe ser NULL.

[out] pEncodedAttributes

Puntero a una estructura de CRYPT_DER_BLOB que contiene un recuento de bytes y un puntero a los atributos codificados del sujeto.

Valor devuelto

Si la función se ejecuta correctamente y el identificador del firmante existe en el CTL, el valor devuelto es TRUE.

Si se produce un error en la función y no encuentra un identificador de sujeto coincidente, el valor devuelto es FALSE.

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

Consulte también

CTL_CONTEXT

CertEnumSubjectInSortedCTL

Funciones de mantenimiento de almacén de certificados y certificados