Fonction SignerTimeStampEx2
La fonction SignerTimeStampEx2 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 peut être utilisée pour effectuer des horodatages d’heure de l’infrastructure à clé publique X.509, conformes À la norme RFC 3161.
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 SignerTimeStampEx2(
_Reserved_ DWORD dwFlags,
_In_ SIGNER_SUBJECT_INFO *pSubjectInfo,
_In_ LPCWSTR pwszHttpTimeStamp,
_In_ ALG_ID dwAlgId,
_In_ PCRYPT_ATTRIBUTES psRequest,
_In_ LPVOID pSipData,
_Out_ SIGNER_CONTEXT **ppSignerContext
);
Paramètres
-
dwFlags [in]
-
Valeur 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. - SIGNER_TIMESTAMP_RFC3161
Spécifie un horodatage conforme À la norme RFC 3161. -
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.
-
dwAlgId [in]
-
Spécifie un algorithme de hachage à utiliser pour effectuer des horodatages conformes À la RFC 3161. Ce paramètre est ignoré pour les horodatages Authenticode.
-
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.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 R2 [applications de bureau uniquement] |
| DLL |
|
Voir aussi