SignerSignEx fonction)
La fonction SignerSignEx signe le fichier spécifié et retourne un pointeur vers les données signées.
Notes
Cette fonction n’a aucun fichier d’en-tête ou bibliothèque d’importation associé. 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 à 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 [ dans]
-
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 _ _ _ _ _ Indicateur de hachages de page PE exclure
- 0x10
Excluez les hachages de page lors de la création de données SIP indirectes pour le fichier PE. Cet indicateur est prioritaire par rapport à l’indicateur d' _ indicateur de _ _ _ hachage _ de page PE Inc .
Si vous ne spécifiez pas l’indicateur de _ _ _ _ hachages _ de page de hachage de page PE de SPC exclure ou si l’indicateur de _ _ _ _ hachage _ de page PE Inc . 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 est d’exclure les hachages de page lors de la création de données SIP indirectes pour les fichiers PE.
Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge.- SPC _ _Indicateur de _ _ _ table _ addr d’importation PE Inc
Cette valeur n’est pas prise en charge. - SPC _ _Indicateur d' _ _ informations de _ DÉbogage PE de Inc .
Cette valeur n’est pas prise en charge. - SPC _ _Indicateur de _ ressources _ PE Inc .
Cette valeur n’est pas prise en charge. - SPC _ _ _ _ _ Identificateurs de hachage de page PE de Inc .
Inclure les hachages de page lors de la création de données SIP indirectes pour le fichier PE.
Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. -
pSubjectInfo [ dans]
-
Pointeur vers une structure d' _ _ informations de sujet du signataire qui spécifie l’objet à signer.
-
pSignerCert [ dans]
-
Pointeur vers une structure de _ certificat de signataire qui spécifie le certificat à utiliser pour créer la signature numérique.
-
pSignatureInfo [ dans]
-
Pointeur vers une structure d' _ _ informations de signature de signataire qui contient des informations sur la signature numérique.
-
pProviderInfo [ dans, facultatif]
-
Pointeur vers une structure d' _ _ informations de fournisseur de signataires qui spécifie le fournisseur de services de chiffrement (CSP) et les informations de clé privée utilisés 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 CSP.
-
pwszHttpTimeStamp [ dans, facultatif]
-
URL d’un serveur d’horodatage.
-
psRequest [ dans, facultatif]
-
Pointeur vers un tableau de structures d' _ attributs de chiffre qui sont 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 [ dans, 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 [ à]
-
Adresse d’un pointeur vers la structure de _ contexte du signataire qui contient l' objet BLOBsigné. Lorsque vous avez terminé d’utiliser la structure du _ contexte du signataire , libérez la structure du _ contexte du signataire en appelant la fonction SignerFreeSignerContext .
Valeur retournée
Si la fonction s’exécute correctement, la fonction retourne la valeur _ 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 communes.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Applications de [ Bureau Windows XP uniquement] |
| Serveur minimal pris en charge |
Applications de bureau Windows Server 2003 [ uniquement] |
| DLL |
|