IOpcDigitalSignature::GetSignatureMethod-Methode (msopc.h)

Ruft die Signaturmethode ab, die zum Berechnen des Werts im SignatureValue-Element des Signaturmarkups verwendet wird.

Syntax

HRESULT GetSignatureMethod(
  [out, retval] LPWSTR *signatureMethod
);

Parameter

[out, retval] signatureMethod

Ein Zeiger auf die 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 signatureMethod-Parameter ist NULL.

Hinweise

Diese Methode weist Arbeitsspeicher zu, der von der Zeichenfolge verwendet wird, die in signatureMethod zurückgegeben wird. Wenn die Methode erfolgreich ist, rufen Sie die CoTaskMemFree-Funktion auf, um den Arbeitsspeicher freizugeben.

Um die Signaturmethode festzulegen, bevor die Signatur generiert wird, rufen Sie die IOpcSigningOptions::SetSignatureMethod-Methode auf.

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. Beide Methoden rufen den Wert ab, der von IOpcSigningOptions::SetSignatureMethod festgelegt wurde.

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 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

Weitere Informationen

Kernverpackungsschnittstellen

Erste Schritte mit der Verpackungs-API

IOpcDigitalSignature

IOpcDigitalSignatureManager

IOpcSigningOptions

Übersichten

Programmierhandbuch für die Paket-API

Verpackungs-API-Referenz

Beispiele für die Paket-API

Packen von Schnittstellen für digitale Signatur

Verpackungsschnittstellen

Referenz