SignerSignEx, fonction

Article
06/13/2023

La fonction SignerSignEx signe le fichier spécifié et retourne un pointeur vers les données signées.

Notes

Cette fonction n’a pas de fichier d’en-tête associé ni de bibliothèque d’importation. Pour appeler cette fonction, vous devez créer un fichier d’en-tête défini par l’utilisateur et utiliser les fonctions LoadLibrary et GetProcAddress pour établir une liaison dynamique vers Mssign32.dll.

Syntaxe

HRESULT WINAPI SignerSignEx(
  _In_     DWORD                 dwFlags,
  _In_     SIGNER_SUBJECT_INFO   *pSubjectInfo,
  _In_     SIGNER_CERT           *pSignerCert,
  _In_     SIGNER_SIGNATURE_INFO *pSignatureInfo,
  _In_opt_ SIGNER_PROVIDER_INFO  *pProviderInfo,
  _In_opt_ LPCWSTR               pwszHttpTimeStamp,
  _In_opt_ PCRYPT_ATTRIBUTES     psRequest,
  _In_opt_ LPVOID                pSipData,
  _Out_    SIGNER_CONTEXT        **ppSignerContext
);

Paramètres

dwFlags [in]

Modifie le comportement de cette fonction.

Si le fichier à signer est un fichier exécutable portable (PE), il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs des valeurs suivantes. Ces identificateurs sont définis dans Mssip.h.

Valeur	Signification
SPC_EXC_PE_PAGE_HASHES_FLAG 0x10	Excluez les hachages de page lors de la création de données indirectes SIP pour le fichier PE. Cet indicateur est prioritaire sur l’indicateur SPC_INC_PE_PAGE_HASHES_FLAG . Si ni l’indicateur SPC_EXC_PE_PAGE_HASHES_FLAG ni l’indicateur SPC_INC_PE_PAGE_HASHES_FLAG n’est spécifié, la valeur définie avec la fonction WintrustSetDefaultIncludePEPageHashes est utilisée pour ce paramètre. La valeur par défaut de ce paramètre consiste à exclure les hachages de page lors de la création de données indirectes SIP pour les fichiers PE. Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge.
SPC_INC_PE_IMPORT_ADDR_TABLE_FLAG 0x20	Cette valeur n’est pas prise en charge.
SPC_INC_PE_DEBUG_INFO_FLAG 0x40	Cette valeur n’est pas prise en charge.
SPC_INC_PE_RESOURCES_FLAG 0x80	Cette valeur n’est pas prise en charge.
SPC_INC_PE_PAGE_HASHES_FLAG 0x100	Incluez des hachages de page lors de la création de données indirectes SIP pour le fichier PE. Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge.

pSubjectInfo [in]

Pointeur vers une structure SIGNER_SUBJECT_INFO qui spécifie l’objet à signer.

pSignerCert [in]

Pointeur vers une structure de SIGNER_CERT qui spécifie le certificat à utiliser pour créer la signature numérique.

pSignatureInfo [in]

Pointeur vers une structure SIGNER_SIGNATURE_INFO qui contient des informations sur la signature numérique.

pProviderInfo [in, facultatif]

Pointeur vers une structure de SIGNER_PROVIDER_INFO qui spécifie le fournisseur de services de chiffrement (CSP) et les informations de clé privée utilisées pour créer la signature numérique.

Si la valeur de ce paramètre est NULL, la valeur du paramètre pSignerCert doit spécifier un certificat associé à un fournisseur de solutions Cloud.

pwszHttpTimeStamp [in, facultatif]

URL d’un serveur d’horodatage.

psRequest [in, facultatif]

Pointeur vers un tableau de structures CRYPT_ATTRIBUTE ajoutées à une demande de signature. Ce paramètre est ignoré si le paramètre pwszHttpTimeStamp ne contient pas de valeur valide qui n’est pas NULL.

pSipData [in, facultatif]

Valeur 32 bits qui est passée en tant que données supplémentaires aux fonctions SIP. Le format et le contenu de ce sont définis par le fournisseur SIP.

ppSignerContext [out]

Adresse d’un pointeur vers la structure SIGNER_CONTEXT qui contient l’objet BLOB signé. Lorsque vous avez terminé d’utiliser la structure SIGNER_CONTEXT , libérez la structure SIGNER_CONTEXT en appelant la fonction SignerFreeSignerContext .

Valeur retournée

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

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Spécifications

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]
DLL	Mssign32.dll

Voir aussi

SignerSign
SignerFreeSignerContext