CryptSIPPutSignedDataMsg, fonction (mssip.h)

Article
02/29/2024

La fonction CryptSIPPutSignedDataMsg stocke une signature Authenticode dans le fichier cible.

Syntaxe

BOOL CryptSIPPutSignedDataMsg(
  [in]  SIP_SUBJECTINFO *pSubjectInfo,
  [in]  DWORD           dwEncodingType,
  [out] DWORD           *pdwIndex,
  [in]  DWORD           cbSignedDataMsg,
  [in]  BYTE            *pbSignedDataMsg
);

Paramètres

[in] pSubjectInfo

Pointeur vers une structure SIP_SUBJECTINFO qui contient des informations sur l’objet du message.

[in] dwEncodingType

Type d’encodage du message. Il peut s’agir d’une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur	Signification
PKCS_7_ASN_ENCODING 65536 (0x10000)	Spécifie l’encodage de message PKCS #7 .
X509_ASN_ENCODING 1 (0x1)	Spécifie l’encodage de certificat X.509 .

[out] pdwIndex

Pointeur vers l’index de message.

[in] cbSignedDataMsg

Longueur, en octets, de la mémoire tampon pointée par le paramètre pbSignedDataMsg .

[in] pbSignedDataMsg

Pointeur vers la mémoire tampon qui contient le message.

Valeur retournée

Si la fonction réussit, la fonction retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError. Certains codes d’erreur possibles suivent.

Code de retour	Description
ERROR_BAD_FORMAT	Le format de fichier ou de données spécifié du package d’interface d’objet (SIP) n’est pas valide.
ERROR_INVALID_PARAMETER	Ce code peut être retourné pour les raisons suivantes : pSubjectInfo a la valeur NULL. PdwIndex a la valeur NULL. PbSignedDataMsg a la valeur NULL. La valeur du paramètre cbSignedDataMsg est inférieure à 1. [SIP_SUBJECTINFO] Structure (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo). [SIP_SUBJECTINFO] Structure (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo).
TRUST_E_SUBJECT_FORM_UNKNOWN	Le type d’objet spécifié n’est pas valide.

Remarques

Chaque type de sujet utilise un sous-ensemble différent de ses données pour le calcul de hachage et nécessite une procédure différente pour le stockage et la récupération. Par conséquent, chaque type de sujet a une spécification SIP unique.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mssip.h
Bibliothèque	Crypt32.lib
DLL	Crypt32.dll

Voir aussi

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg

Partager via