CryptMsgCountersign-Funktion (wincrypt.h)

Die Funktion CryptMsgCountersign signiert eine vorhandene Signatur in einer Nachricht gegen. Gegensignaturen werden verwendet, um den verschlüsselten Hash der Nachricht einer vorhandenen Signatur zu signieren. Gegensignaturen können für verschiedene Zwecke verwendet werden, z. B. für den Zeitstempel einer Nachricht.

Syntax

BOOL CryptMsgCountersign(
  [in, out] HCRYPTMSG                hCryptMsg,
  [in]      DWORD                    dwIndex,
  [in]      DWORD                    cCountersigners,
  [in]      PCMSG_SIGNER_ENCODE_INFO rgCountersigners
);

Parameter

[in, out] hCryptMsg

Zu verwendende kryptografische Nachrichtenhandle.

[in] dwIndex

Nullbasierter Index des Signaturgebers in der signierten oder signierten und umhüllten Nachricht, die gegensigniert werden soll.

[in] cCountersigners

Anzahl der Countersigner im Array "rgCountersigners ".

[in] rgCountersigners

Array von CMSG_SIGNER_ENCODE_INFO Strukturen von Countersignern.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero (TRUE) zurück.

Wenn die Funktion fehlschlägt, gibt sie null (FALSE) zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Ein Fehler kann von CryptMsgCountersignEncoded weitergegeben werden.

Die folgenden Fehlercodes werden am häufigsten zurückgegeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
ERROR_MORE_DATA	Der angegebene Bereich ist nicht groß genug, um die zurückgegebenen Daten aufzunehmen.

 

Wenn die Funktion fehlschlägt, gibt GetLastError möglicherweise einen ASN.1-Codierungs-/Decodierungsfehler ( Abstract Syntax Notation One ) zurück. Informationen zu diesen Fehlern finden Sie unter ASN.1 Encoding/Decoding Return Values.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll

Weitere Informationen

CryptMsgCountersignEncoded

CryptMsgVerifyCountersignatureEncoded

Nachrichtenfunktionen auf niedriger Ebene

Vereinfachte Nachrichtenfunktionen