IOpcDigitalSignature::GetSignatureValue-Methode (msopc.h)

Artikel
08/25/2023

Ruft den decodierten Wert im SignatureValue-Element des Signaturmarkups ab.

Syntax

HRESULT GetSignatureValue(
  [out] UINT8  **signatureValue,
  [out] UINT32 *count
);

Parameter

[out] signatureValue

Ein Zeiger auf einen Puffer, der den decodierten Wert im SignatureValue-Element des Signaturmarkups enthält.

[out] count

Die Größe des signaturHashValue-Puffers .

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 signatureValue- und count-Parameter ist NULL.

Hinweise

Diese Methode weist Arbeitsspeicher zu, der vom in signatureValue zurückgegebenen Puffer verwendet wird. Wenn die Methode erfolgreich ist, rufen Sie die CoTaskMemFree-Funktion auf, um den Arbeitsspeicher freizugeben.

Das SignatureValue-Element enthält einen Base64-codierten Wert, der durch Anwenden der Signaturmethode auf das SignedInfo-Element des Signaturmarkups berechnet wurde. Um die Signaturmethode abzurufen, rufen Sie die GetSignatureMethod-Methode auf.

Wenn Sie die APIs zum Generieren einer Signatur verwenden, legen Sie die Signaturmethode fest, indem Sie die IOpcSigningOptions::SetSignatureMethod-Methode aufrufen.

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