CRYPT_SIGN_MESSAGE_PARA-Struktur (wincrypt.h)
Die CRYPT_SIGN_MESSAGE_PARA-Struktur enthält Informationen zum Signieren von Nachrichten mithilfe eines angegebenen Signaturzertifikatkontexts.
Syntax
typedef struct _CRYPT_SIGN_MESSAGE_PARA {
DWORD cbSize;
DWORD dwMsgEncodingType;
PCCERT_CONTEXT pSigningCert;
CRYPT_ALGORITHM_IDENTIFIER HashAlgorithm;
void *pvHashAuxInfo;
DWORD cMsgCert;
PCCERT_CONTEXT *rgpMsgCert;
DWORD cMsgCrl;
PCCRL_CONTEXT *rgpMsgCrl;
DWORD cAuthAttr;
PCRYPT_ATTRIBUTE rgAuthAttr;
DWORD cUnauthAttr;
PCRYPT_ATTRIBUTE rgUnauthAttr;
DWORD dwFlags;
DWORD dwInnerContentType;
CRYPT_ALGORITHM_IDENTIFIER HashEncryptionAlgorithm;
void *pvHashEncryptionAuxInfo;
} CRYPT_SIGN_MESSAGE_PARA, *PCRYPT_SIGN_MESSAGE_PARA;
Member
cbSize
Größe dieser Struktur in Bytes.
dwMsgEncodingType
Verwendeter Codierungstyp. Es ist immer akzeptabel, sowohl den Zertifikat- als auch den Nachrichtencodierungstyp anzugeben, indem sie mit einem bitweisen OR-Vorgang kombiniert werden, wie im folgenden Beispiel gezeigt:
X509_ASN_ENCODING | PKCS_7_ASN_ENCODING
Derzeit definierte Codierungstypen sind:
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
pSigningCert
Ein Zeiger auf die CERT_CONTEXT , die bei der Signatur verwendet werden soll.
Entweder die CERT_KEY_PROV_INFO_PROP_ID oder CERT_KEY_CONTEXT_PROP_ID-Eigenschaft muss für den Kontext festgelegt werden, um Zugriff auf den privaten Signaturschlüssel zu gewähren.
HashAlgorithm
CRYPT_ALGORITHM_IDENTIFIER mit dem Hashingalgorithmus, der zum Hashen der zu signierten Daten verwendet wird.
pvHashAuxInfo
Derzeit nicht verwendet, und muss auf NULL festgelegt werden.
cMsgCert
Anzahl der Elemente im rgpMsgCert-Array von CERT_CONTEXT Strukturen. Wenn auf null festgelegt ist, sind keine Zertifikate in der signierten Nachricht enthalten.
rgpMsgCert
Array von Zeigern auf CERT_CONTEXT Strukturen, die in die signierte Nachricht eingeschlossen werden sollen. Wenn das pSigningCert eingeschlossen werden soll, muss sich ein Zeiger darauf im rgpMsgCert-Array befinden.
cMsgCrl
Anzahl der Elemente im rgpMsgCrl-Array von Zeigern auf CRL_CONTEXT Strukturen. Wenn dieser Wert auf 0 festgelegt ist, sind keine CRL_CONTEXT Strukturen in der signierten Nachricht enthalten.
rgpMsgCrl
Array von Zeigern auf CRL_CONTEXT Strukturen, die in die signierte Nachricht eingeschlossen werden sollen.
cAuthAttr
Anzahl der Elemente im rgAuthAttr-Array . Wenn in rgAuthAttr keine authentifizierten Attribute vorhanden sind, wird dieser Member auf 0 (null) festgelegt.
rgAuthAttr
Array von Zeigern auf CRYPT_ATTRIBUTE Strukturen, die jeweils authentifizierte Attributinformationen enthalten. Wenn authentifizierte Attribute vorhanden sind, schreibt der PKCS #9-Standard vor, dass mindestens zwei Attribute vorhanden sein müssen: der Inhaltstypobjektbezeichner (OID) und der Hash der Nachricht selbst. Diese Attribute werden automatisch vom System hinzugefügt.
cUnauthAttr
Anzahl der Elemente im rgUnauthAttr-Array . Wenn in rgUnauthAttr keine nicht authentifizierten Attribute vorhanden sind, ist dieser Member null.
rgUnauthAttr
Array von Zeigern auf CRYPT_ATTRIBUTE Strukturen, die jeweils nicht authentifizierte Attributinformationen enthalten. Nicht authentifizierte Attribute können unter anderem verwendet werden, um Gegensignaturen zu enthalten.
dwFlags
Normalerweise 0. Wenn die codierte Ausgabe ein CMSG_SIGNED innerer Inhalt einer äußeren kryptografischen Nachricht sein soll, z. B. eine CMSG_ENVELOPED Nachricht, muss die CRYPT_MESSAGE_BARE_CONTENT_OUT_FLAG festgelegt werden. Wenn sie nicht festgelegt ist, wird die Nachricht als innerer Inhaltstyp CMSG_DATA codiert.
CRYPT_MESSAGE_ENCAPSULATED_CONTENT_OUT_FLAG kann so festgelegt werden, dass innere Inhalte , die keine Daten enthalten, in eine OKTETTZEICHENFOLGE gekapselt werden. CRYPT_MESSAGE_KEYID_SIGNER_FLAG kann so festgelegt werden, dass Die Unterzeichner anhand ihres Schlüsselbezeichners und nicht anhand des Ausstellers und der Seriennummer identifiziert werden.
CRYPT_MESSAGE_SILENT_KEYSET_FLAG kann so festgelegt werden, dass eine beliebige Benutzeroberfläche durch den CSP unterdrückt wird. Weitere Informationen zum CRYPT_SILENT-Flag finden Sie unter CryptAcquireContext.
dwInnerContentType
Normalerweise 0. Legen Sie auf den Codierungstyp der Eingabenachricht fest, wenn die zu signierte Eingabe die codierte Ausgabe einer anderen kryptografischen Nachricht ist.
HashEncryptionAlgorithm
Ein CRYPT_ALGORITHM_IDENTIFIER. Wenn vorhanden und nicht NULL, wird es anstelle des PublicKeyInfo.Algorithm-Zertifikatselements des Signierers verwendet. Beachten Sie, dass der Hashverschlüsselungsalgorithmus für RSA normalerweise mit dem Algorithmus für öffentliche Schlüssel identisch ist. Für DSA ist der Hashverschlüsselungsalgorithmus normalerweise ein DSS-Signaturalgorithmus. Dieser Member kann nur verwendet werden, wenn CRYPT_SIGN_MESSAGE_PARA_HAS_CMS_FIELDS definiert ist.
pvHashEncryptionAuxInfo
Derzeit nicht verwendet und muss auf NULL festgelegt werden. Dieser Member kann nur verwendet werden, wenn CRYPT_SIGN_MESSAGE_PARA_HAS_CMS_FIELDS definiert ist.
Hinweise
Die Member HashEncryptionAlgorithm und pvHashEncryptionAuxInfo können nur verwendet werden, wenn CRYPT_SIGN_MESSAGE_PARA_HAS_CMS_FIELDS definiert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Kopfzeile | wincrypt.h |