Metodo IOpcDigitalSignatureManager::Validate (msopc.h)

Articolo
03/05/2024

Convalida una firma del pacchetto specificata usando un certificato specificato.

Sintassi

HRESULT Validate(
  [in]          IOpcDigitalSignature            *signature,
  [in]          const CERT_CONTEXT              *certificate,
  [out, retval] OPC_SIGNATURE_VALIDATION_RESULT *validationResult
);

Parametri

[in] signature

Puntatore dell'interfaccia IOpcDigitalSignature che rappresenta la firma da convalidare.

[in] certificate

Puntatore a una struttura CERT_CONTEXT che contiene un certificato usato per convalidare la firma.

[out, retval] validationResult

Valore che descrive il risultato del controllo di convalida.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Almeno una delle firme, del certificato e dei parametri validationResult è NULL.

Commenti

Questo metodo non esegue controlli di sicurezza su un certificato dell'infrastruttura di chiave pubblica X.509; il chiamante deve eseguire i controlli per revoche, scadenza, catena di certificati e tutti gli altri controlli necessari.

Questo metodo verifica che la firma specificata (entità firmate e il markup della firma) non sia stata modificata dal momento che la firma è stata generata, ma non convalida l'identità del firmatario.

Importante Il chiamante deve convalidare l'identità del firmatario.

Se si verificano errori in una firma del pacchetto, alcuni di questi errori potrebbero non essere esposti finché questo metodo non viene chiamato.

Thread safety

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h