Fonction CryptMsgCalculateEncodedLength (wincrypt.h)

Article
08/27/2023

La fonction CryptMsgCalculateEncodedLength calcule le nombre maximal d’octets nécessaires pour un message de chiffrement encodé en fonction du type de message, des paramètres d’encodage et de la longueur totale des données à encoder. Notez que le résultat sera toujours supérieur ou égal au nombre réel d’octets nécessaires.

Syntaxe

DWORD CryptMsgCalculateEncodedLength(
  [in]           DWORD      dwMsgEncodingType,
  [in]           DWORD      dwFlags,
  [in]           DWORD      dwMsgType,
  [in]           void const *pvMsgEncodeInfo,
  [in, optional] LPSTR      pszInnerContentObjID,
  [in]           DWORD      cbData
);

Paramètres

[in] dwMsgEncodingType

Spécifie le type d’encodage utilisé. Il est toujours acceptable de spécifier les types d’encodage de certificat et de message en les combinant avec une opération OR au niveau du bit, comme illustré dans l’exemple suivant :

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Les types d’encodage actuellement définis sont les suivants :

X509_ASN_ENCODING
PKCS_7_ASN_ENCODING

[in] dwFlags

Les indicateurs actuellement définis sont indiqués dans le tableau suivant.

Valeur	Signification
CMSG_BARE_CONTENT_FLAG	Indique que la sortie diffusée en continu n’aura pas de wrapper ContentInfo externe (tel que défini par PKCS #7). Cela le rend approprié pour être diffusé en continu dans un message englobant.
CMSG_DETACHED_FLAG	Indique que des données détachées sont fournies pour les appels suivants à CryptMsgUpdate.
CMSG_CONTENTS_OCTETS_FLAG	Utilisé pour calculer la taille d’un encodage DER d’un message à imbriquer à l’intérieur d’un message enveloppe. Cela est particulièrement utile lorsque la diffusion en continu est effectuée.
CMSG_CMS_ENCAPSULATED_CONTENT_FLAG	Le contenu interne non de type de données est encapsulé dans une chaîne OCTET. Cet indicateur s’applique aux messages signés et enveloppes.

[in] dwMsgType

Les types de messages actuellement définis sont indiqués dans le tableau suivant.

Valeur	Signification
CMSG_DATA	Chaîne d’octet (BYTE).
CMSG_SIGNED	CMSG_SIGNED_ENCODE_INFO
CMSG_ENVELOPED	CMSG_ENVELOPED_ENCODE_INFO
CMSG_SIGNED_AND_ENVELOPED	Non implémenté.
CMSG_HASHED	CMSG_HASHED_ENCODE_INFO
CMSG_ENCRYPTED	Non implémenté.

[in] pvMsgEncodeInfo

Pointeur vers les données à encoder. Le type de données pointées vers dépend de la valeur de dwMsgType. Pour plus d’informations, consultez la table dwMsgType .

[in, optional] pszInnerContentObjID

Lorsque vous appelez CryptMsgCalculateEncodedLength avec des données fournies à CryptMsgUpdate déjà encodées, l’identificateur d’objet approprié est passé dans pszInnerContentObjID. Si pszInnerContentObjID a la valeur NULL, le type de contenu interne est supposé ne pas avoir été encodé précédemment et est encodé en tant que chaîne d’octets et donné le type CMSG_DATA.

Lorsque la diffusion en continu est utilisée, pszInnerContentObjID doit être NULL ou szOID_RSA_data.

Les identificateurs d’objet d’algorithme suivants sont couramment utilisés :

szOID_RSA_data
szOID_RSA_signedData
szOID_RSA_envelopedData
szOID_RSA_signEnvData
szOID_RSA_digestedData
szOID_RSA_encryptedData
SPC_INDIRECT_DATA_OBJID

Un utilisateur peut définir une nouvelle utilisation interne du contenu . L’utilisateur doit s’assurer que l’expéditeur et le destinataire du message sont d’accord sur la sémantique associée à l’identificateur d’objet.

[in] cbData

Taille, en octets, du contenu.

Valeur retournée

Retourne la longueur requise pour un message de chiffrement encodé. Cette longueur n’est peut-être pas la longueur exacte, mais elle ne sera pas inférieure à la longueur requise. Zéro est retourné si la fonction échoue.

Pour récupérer des informations d’erreur étendues, utilisez la fonction GetLastError . Le tableau suivant répertorie les codes d’erreur les plus couramment retournés.

Code de retour	Description
CRYPT_E_INVALID_MSG_TYPE	Le type de message n'est pas valide.
CRYPT_E_UNKNOWN_ALGO	L’algorithme de chiffrement est inconnu.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wincrypt.h
Bibliothèque	Crypt32.lib
DLL	Crypt32.dll

Voir aussi

CryptMsgOpenToEncode

Fonctions de message de bas niveau

Fonctions de message simplifiées

Partager via