Funzione CertEnumSubjectInSortedCTL (wincrypt.h)

Articolo
08/27/2023

La funzione CertEnumSubjectInSortedCTL recupera il primo o il successivo TrustedSubject in un elenco di attendibilità dei certificati ordinato (CTL). Un CTL ordinato è un elenco di scopi consentiti creato con il set di CERT_CREATE_CONTEXT_SORTED_FLAG. Usata in un ciclo, questa funzione può recuperare in sequenza tutti gli oggetti TrustedSubject in un CTL ordinato.

Sintassi

BOOL CertEnumSubjectInSortedCTL(
  [in]      PCCTL_CONTEXT   pCtlContext,
  [in, out] void            **ppvNextSubject,
  [out]     PCRYPT_DER_BLOB pSubjectIdentifier,
  [out]     PCRYPT_DER_BLOB pEncodedAttributes
);

Parametri

[in] pCtlContext

Puntatore alla struttura CTL_CONTEXT da cercare.

[in, out] ppvNextSubject

Puntatore all'indirizzo dell'ultimo oggetto TrustedSubject trovato. Per avviare l'enumerazione, ppvNextSubject deve puntare a un puntatore impostato su NULL. Al ritorno, il puntatore indirizzato da ppvNextSubject viene aggiornato in modo che punti alla successiva TrustedSubject nella sequenza codificata.

[out] pSubjectIdentifier

Puntatore a una struttura CRYPT_DER_BLOB , identificando in modo univoco un oggetto TrustedSubject. Le informazioni contenute in questa struttura possono essere un hash o qualsiasi sequenza di byte univoca.

[out] pEncodedAttributes

Puntatore a una struttura CRYPT_DER_BLOB contenente un conteggio di byte e un puntatore agli attributi codificati di TrustedSubject.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE, con ppvNextSubject aggiornato in modo che punti alla successiva TrustedSubject nella sequenza codificata.

Se la funzione ha esito negativo, il valore restituito è FALSE. Il valore restituito è FALSE se non sono presenti più soggetti o se è presente un argomento non valido.

Commenti

I membri pbData delle strutture CRYPT_DER_BLOB puntano direttamente ai byte codificati. Le strutture CRYPT_DER_BLOB , se stesse, devono essere allocate e liberate dall'applicazione, ma la memoria indirizzata dai membri pbData di queste strutture non viene allocata dall'applicazione e non deve essere liberata dall'applicazione.

Se il CTL non è ordinato con il flag CERT_CREATE_CONTEXT_SORTED_FLAG impostato, viene restituito un errore.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
Libreria	Crypt32.lib
DLL	Crypt32.dll

Vedi anche

CTL_CONTEXT

CertFindSubjectInSortedCTL

Funzioni di manutenzione dell'archivio certificati e certificati

Condividi tramite