Funzione CryptVerifyCertificateSignatureEx (wincrypt.h)

La funzione CryptVerifyCertificateSignatureEx verifica la firma di un certificato soggetto, un elenco di revoche di certificati, una richiesta di certificato o una richiesta keygen usando la chiave pubblica dell'autorità emittente. La funzione non richiede l'accesso a una chiave privata.

Sintassi

BOOL CryptVerifyCertificateSignatureEx(
  [in]                HCRYPTPROV_LEGACY hCryptProv,
  [in]                DWORD             dwCertEncodingType,
  [in]                DWORD             dwSubjectType,
  [in]                void              *pvSubject,
  [in]                DWORD             dwIssuerType,
  [in]                void              *pvIssuer,
  [in]                DWORD             dwFlags,
  [in, out, optional] void              *pvExtra
);

Parametri

[in] hCryptProv

Questo parametro non viene usato e deve essere impostato su NULL.

Windows Server 2003 e Windows XP: Handle per il provider del servizio di crittografia usato per verificare la firma. Il tipo di dati di questo parametro è HCRYPTPROV.

Viene passato NULL a meno che non vi sia un motivo sicuro per il passaggio di un provider di crittografia specifico. Il passaggio di NULL determina l'acquisizione del provider RSA o DSS predefinito.

[in] dwCertEncodingType

Tipo di codifica del certificato usato per crittografare l'oggetto. L'identificatore del tipo di codifica del messaggio , contenuto nell'alto word di questo valore, viene ignorato da questa funzione.

Questo parametro può essere il tipo di codifica del certificato attualmente definito di seguito.

[in] dwSubjectType

Tipo di oggetto. Questo parametro può essere uno dei tipi di oggetto seguenti.

[in] pvSubject

Puntatore a una struttura del tipo indicato da dwSubjectType che contiene la firma da verificare.

[in] dwIssuerType

Tipo di autorità di certificazione. Questo parametro può essere uno dei tipi di autorità di certificazione seguenti.

[in] pvIssuer

Puntatore a una struttura del tipo indicato dal valore di dwIssuerType. La struttura contiene l'accesso alla chiave pubblica necessaria per verificare la firma.

[in] dwFlags

Flag che modificano il comportamento della funzione. Può essere zero o un OR bit per bit dei valori seguenti.

[in, out, optional] pvExtra

Puntatore a una struttura CRYPT_VERIFY_CERT_SIGN_STRONG_PROPERTIES_INFO se il parametro dwFlags è impostato su CRYPT_VERIFY_CERT_SIGN_RETURN_STRONG_PROPERTIES_FLAG.

È necessario chiamare CryptMemFree per liberare la struttura.

Valore restituito

Restituisce un valore diverso da zero se ha esito positivo o zero in caso contrario.

Per informazioni sugli errori estesi, chiamare GetLastError.

Se la funzione ha esito negativo, GetLastError potrebbe restituire un errore di codifica astratta Notation One (ASN.1). Per informazioni su questi errori, vedere Codifica ASN.1/Decodifica dei valori restituiti.

Commenti

Il buffer soggetto può contenere un BLOB codificato o un contesto per un certificato o CRL. Nel caso di un contesto di certificato, se i parametri della chiave pubblica del certificato sono mancanti e se questi parametri possono essere ereditati dall'autorità di certificazione del certificato, ad esempio dal parametro chiave pubblica DSS, la proprietà CERT_PUBKEY_ALG_PARA_PROP_ID del contesto viene aggiornata con i parametri dell'algoritmo di chiave pubblica dell'autorità emittente per una firma valida.

Requisiti

Vedi anche

CryptVerifyCertificateSignature