Fonction SignerTimeStampEx

Article
06/13/2023

La fonction SignerTimeStampEx marque l’heure de l’objet spécifié et retourne éventuellement un pointeur vers une structure SIGNER_CONTEXT qui contient un pointeur vers un objet BLOB. Cette fonction prend en charge l’horodatage Authenticode. Pour effectuer l’horodatage RFC 3161 (Public Key Infrastructure) X.509, utilisez la fonction SignerTimeStampEx2 .

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 lier dynamiquement à Mssign32.dll.

Syntaxe

HRESULT WINAPI SignerTimeStampEx(
  _Reserved_ DWORD               dwFlags,
  _In_       SIGNER_SUBJECT_INFO *pSubjectInfo,
  _In_       LPCWSTR             pwszHttpTimeStamp,
  _In_       PCRYPT_ATTRIBUTES   psRequest,
  _In_       LPVOID              pSipData,
  _Out_      SIGNER_CONTEXT      **ppSignerContext 
);

Paramètres

dwFlags [in]

Réservé. Ce paramètre doit être défini sur zéro.

pSubjectInfo [in]

Adresse d’une structure de SIGNER_SUBJECT_INFO qui représente le sujet à horodatage.

pwszHttpTimeStamp [in]

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

psRequest [in]

Optionnel. Adresse d’une structure de CRYPT_ATTRIBUTES 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 [in]

Optionnel. Valeur 32 bits transmise en tant que données supplémentaires aux fonctions SIP ( Subject Interface Package ). 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 [out]

Optionnel. Adresse d’un pointeur vers la structure SIGNER_CONTEXT qui contient l’objet BLOB signé. Une fois que vous avez terminé d’utiliser la structure SIGNER_CONTEXT , libérez-la 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.

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

Voir aussi


SignerTimeStamp