CryptSIPPutSignedDataMsg, fonction (mssip.h)

  • Article

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