IOpcSigningOptions::SetSignatureMethod-Methode (msopc.h)

Artikel
02/29/2024

Legt die Signaturmethode fest, die zum Berechnen und Verschlüsseln des Hashwerts des SignedInfo-Elements verwendet werden soll, das im SignatureValue-Element der Signatur enthalten ist.

Syntax

HRESULT SetSignatureMethod(
  [in] LPCWSTR signatureMethod
);

Parameter

[in] signatureMethod

Die zu verwendende Signaturmethode.

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	Der parameter signatureMethod ist NULL.

Hinweise

Um auf die Signaturmethode zuzugreifen, bevor die Signatur generiert wird, rufen Sie IOpcSigningOptions::GetSignatureMethod auf. Um nach der Signaturgenerierung auf die Signaturmethode zuzugreifen, rufen Sie die IOpcDigitalSignature::GetSignatureMethod-Methode auf.

Wichtig Eine gültige Signaturmethode muss festgelegt werden, bevor die Signatur durch Aufrufen der IOpcDigitalSignatureManager::Sign-Methode generiert wird.

Wenn eine Signatur generiert wird, wird sie als Signaturmarkup serialisiert. Die Signaturmethode wird verwendet, um den Wert im SignatureValue-Element im Signaturmarkup zu berechnen.

Wenn eine Signatur überprüft wird, wird die Signaturmethode verwendet, um diesen Wert neu zu berechnen, und der neu berechnete Wert wird mit dem Wert im SignatureValue-Element im Signaturmarkup verglichen.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-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