Funzione CertFindSubjectInSortedCTL (wincrypt.h)

La funzione CertFindSubjectInSortedCTL tenta di trovare l'oggetto specificato in un elenco di certificati attendibili (CTL) ordinato. Un soggetto può essere identificato dall'intero contesto del certificato o da qualsiasi identificatore univoco dell'oggetto del certificato, ad esempio l'hash SHA1 dell'autorità emittente del certificato e il numero di serie.

Sintassi

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

Parametri

[in] pSubjectIdentifier

Puntatore a una struttura CRYPT_DATA_BLOB che identifica in modo univoco il soggetto. Le informazioni contenute in questa struttura possono essere un hash o qualsiasi sequenza di byte univoca.

[in] pCtlContext

Puntatore alla struttura CTL_CONTEXT da cercare.

[in] dwFlags

Riservato per uso futuro e deve essere NULL.

[in] pvReserved

Riservato per uso futuro e deve essere NULL.

[out] pEncodedAttributes

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

Valore restituito

Se la funzione ha esito positivo e l'identificatore del soggetto esiste nel CTL, il valore restituito è TRUE.

Se la funzione ha esito negativo e non individua un identificatore del soggetto corrispondente, il valore restituito è FALSE.

Requisiti

Requisito	Valore
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

CertEnumSubjectInSortedCTL

Funzioni di manutenzione dell'archivio certificati e certificati