Compartir a través de


Función CertFindSubjectInSortedCTL (wincrypt.h)

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