Freigeben über


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