IOpcDigitalSignatureManager::Validate-Methode (msopc.h)

Artikel
08/25/2023

Überprüft eine angegebene Paketsignatur mithilfe eines angegebenen Zertifikats.

Syntax

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

Parameter

[in] signature

Ein IOpcDigitalSignature-Schnittstellenzeiger , der die zu überprüfende Signatur darstellt.

[in] certificate

Ein Zeiger auf eine CERT_CONTEXT-Struktur , die ein Zertifikat enthält, das zum Überprüfen der Signatur verwendet wird.

[out, retval] validationResult

Ein Wert, der das Ergebnis der Überprüfung beschreibt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Mindestens einer der Parameter signature, certificate und validationResult ist NULL.

Hinweise

Diese Methode führt keine Sicherheitsüberprüfungen für ein X.509-Infrastrukturzertifikat für öffentliche Schlüssel durch. Der Aufrufer muss die Überprüfungen auf Widerruf, Ablauf, Zertifikatkette und alle anderen erforderlichen Überprüfungen durchführen.

Diese Methode überprüft, ob die angegebene Signatur (signierte Entitäten und das Signaturmarkup) seit der Generierung der Signatur nicht geändert wurde. Die Identität des Signaturgebers wird jedoch nicht überprüft.

Wichtig Der Aufrufer muss die Identität des Unterzeichners überprüfen.

Wenn fehler in einer Paketsignatur vorhanden sind, werden einige dieser Fehler möglicherweise erst verfügbar gemacht, wenn diese Methode aufgerufen wird.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h