IWSDSignatureProperty::GetSignedInfoHash-Methode (wsdbase.h)

Artikel
03/04/2024

Ruft den Hash einer Nachrichtensignatur ab.

Syntax

HRESULT GetSignedInfoHash(
  [out]     BYTE  *pbSignedInfoHash,
  [in, out] DWORD *pdwHashSize
);

Parameter

[out] pbSignedInfoHash

Ein Zeiger auf einen Puffer, der mit dem Hash der Nachrichtensignatur gefüllt wird.

[in, out] pdwHashSize

Bei der Eingabe die Größe von pbSignedInfoHash in Bytes. In der Ausgabe enthält pdwHashSize die tatsächliche Größe des Puffers, der geschrieben wurde.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_NOTAVAIL	Die Nachricht ist nicht signiert.
HRESULT_FROM_WIN32(ERROR_MORE_DATA)	pbSignedInfoHash ist nicht groß genug, um die Informationen aufzunehmen. pdwHashSize gibt jetzt die erforderliche Puffergröße an.

Hinweise

Dies ist der Hash des <Knotens SignedInfo> . Der <Xml-Knoten SignedInfo> enthält die SHA1-Hashes der verschiedenen Teile der Signatur, die in die Signatur eingeschlossen werden sollen. Die endgültige XML-Nachrichtensignatur wird berechnet, indem der Hash des <Knotens SignedInfo> mit dem privaten Schlüssel des Signaturzertifikats signiert wird.

Wenn NULL an pbSignedInfoHash übergeben wird, gibt GetSignedInfoHash die Größe des Puffers zurück, der im pdwHashSize-Parameter zugeordnet werden soll.

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	wsdbase.h (include Wsdapi.h)
DLL	Wsdapi.dll

Weitere Informationen

IWSDSignatureProperty

Freigeben über