SignerTimeStampEx3 fonction)

L’heure de la fonction SignerTimeStampEx3 marque l’objet spécifié et prend en charge la définition des horodatages sur plusieurs signatures.

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 SignerTimeStampEx3(
  _In_       DWORD                  dwFlags,
  _In_       DWORD                  dwIndex,
  _In_       SIGNER_SUBJECT_INFO    *pSubjectInfo,
  _In_       PCWSTR                 pwszHttpTimeStamp,
  _In_       PCWSTR                 pszAlgorithmOid,
  _In_opt_   PCRYPT_ATTRIBUTES      psRequest,
  _In_opt_   PVOID                  pSipData,
  _Out_      SIGNER_CONTEXT         **ppSignerContext,
  _In_opt_   PCERT_STRONG_SIGN_PARA pCryptoPolicy,
  _Reserved_ PVOID                  pReserved
);

Paramètres

dwFlags [ dans]

Indicateur qui spécifie le type d’horodatage à générer. Ce paramètre peut prendre les valeurs suivantes. Les valeurs s’excluent mutuellement.

Valeur Signification
SIGNER_TIMESTAMP_AUTHENTICODE
Spécifie un horodatage Authenticode.
[!Note]
Authenticode n’est plus le type d’horodatage préféré. La prise en charge des horodatages Authenticode peut être supprimée à l’avenir. Nous vous recommandons d’utiliser à la place la RFC 3161.

SIGNER_TIMESTAMP_RFC3161
Spécifie un horodatage conforme à la norme RFC 3161.

dwIndex [ dans]

Spécifie le numéro de séquence de la signature à laquelle l’horodateur sera ajouté. Si cette valeur est égale à zéro (0), la signature externe sera horodatage.

pSubjectInfo [ dans]

Adresse d’une structure d' _ _ informations de sujet du signataire qui représente l’objet à horodater.

pwszHttpTimeStamp [ dans]

Adresse d’une chaîne Unicode terminée par le caractère null qui contient l’URL d’un serveur d’horodatage.

pszAlgorithmOid [ dans]

Algorithme de hachage à utiliser pour exécuter des horodatages conformes à la norme RFC 3161. Ce paramètre est ignoré pour les horodatages Authenticode.

psRequest [ dans, facultatif]

Optionnel. Adresse d’une structure d' _ attributs de chiffre qui contient des attributs supplémentaires ajoutés à la demande d’horodatage.

Ce paramètre est facultatif et peut avoir la valeur null s’il n’est pas inclus.

pSipData [ dans, facultatif]

Optionnel. Valeur 32 bits qui est passée en tant que données supplémentaires aux fonctions du package d’interface de sujet (SIP). Le format et le contenu de ce paramètre sont définis par le fournisseur SIP.

Ce paramètre est facultatif et peut avoir la valeur null s’il n’est pas inclus.

ppSignerContext [ à]

facultatif. Adresse d’un pointeur vers la structure de _ contexte du signataire qui contient l’objet BLOB signé. Lorsque vous avez terminé d’utiliser la structure du _ contexte du signataire , libérez-la en appelant la fonction SignerFreeSignerContext .

pCryptoPolicy [ dans, facultatif]

S’il est présent, pointeur vers une structure de _ _ _ paragraphe de signe fort de certificat qui contient les paramètres utilisés pour vérifier les signatures fortes. L’horodatage doit passer cette stratégie de chiffrement.

Respecté

Réservé. Cette valeur doit être null.

Valeur de retour

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. Les codes d’erreur possibles retournés par cette fonction incluent, mais ne sont pas limités à, les éléments suivants. Pour obtenir la liste des codes d’erreur courants, consultez valeurs HRESULT communes.

Code de retour Description
E_INVALIDARG
Cette erreur peut être retournée pour les conditions suivantes :
  • Vous devez définir SIGNER_TIMESTAMP_AUTHENTICODE ou SIGNER_TIMESTAMP_RFC3161 pour le paramètre dwFlags .
  • Le paramètre conserved doit avoir la valeur null.
  • Si vous définissez l’indicateur SIGNER_TIMESTAMP_AUTHENTICODE dans le paramètre dwFlags , vous devez définir le paramètre dwIndex sur zéro.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 8 [ applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2012 [ applications de bureau uniquement]
DLL
Mssign32.dll

Voir aussi

SignerTimeStamp

SignerTimeStampEx

SignerTimeStampEx2