Metodo IXpsSignature::Verify (xpsdigitalsignature.h)
Verifica la firma su un certificato X.509 specificato.
Sintassi
HRESULT Verify(
[in] const CERT_CONTEXT *x509Certificate,
[out, retval] XPS_SIGNATURE_STATUS *sigStatus
);
Parametri
[in] x509Certificate
Struttura CERT_CONTEXT contenente il certificato X.509 che verrà usato per la verifica.
Se la firma non è incompleta o incompilata, questo certificato verrà usato solo per verificare che i dati firmati nel pacchetto XPS siano intatti. Il certificato non verrà usato per eseguire altri controlli. Prima di usare il certificato, è previsto che l'applicazione verifichi la catena di attendibilità e tutti gli altri requisiti.
[out, retval] sigStatus
Valore XPS_SIGNATURE_STATUS che descrive i risultati della verifica.
Valore restituito
Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per i valori restituiti non elencati in questa tabella, vedere Errori dell'API firma digitale XPS e errori del documento XPS.
| Codice restituito | Descrizione |
|---|---|
|
Il metodo è riuscito. |
|
x509Certificate o sigStatus è NULL. |
|
L'interfaccia non è connessa alla gestione firme. |
Commenti
Questo metodo rileva lo stato della firma nell'ordine specificato nella sezione 10.2.1.2 della specifica di carta XML. La sequenza di rilevamento è la seguente: incompliante, incompleta, interrotta, interrogabile e, infine, valida. Ciò significa che, se, ad esempio, viene trovata una firma incompliante, non verrà calcolato alcun digest se la firma viene interrotta.
Per altre informazioni sui diversi tipi di stato della firma che possono essere rilevati da questo metodo, vedere XPS_SIGNATURE_STATUS.
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | xpsdigitalsignature.h |