CryptUIWizDigitalSign, fonction (cryptuiapi.h)
[La fonction CryptUIWizDigitalSign peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]
La fonction CryptUIWizDigitalSign signe numériquement un document ou un objet BLOB. Le document ou l’objet BLOB peut être signé avec ou sans interaction de l’utilisateur.
Syntaxe
BOOL CryptUIWizDigitalSign(
[in] DWORD dwFlags,
[in, optional] HWND hwndParent,
[in, optional] LPCWSTR pwszWizardTitle,
[in] PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO pDigitalSignInfo,
[out, optional] PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext
);
Paramètres
[in] dwFlags
Contient des indicateurs qui modifient le comportement de la fonction. Il peut s’agir de zéro ou de la valeur suivante.
| Valeur | Signification |
|---|---|
|
Cette fonction signe le document en fonction des informations de la structure CRYPTUI_WIZ_DIGITAL_SIGN_INFO pointée par le paramètre pDigitalSignInfo sans afficher d’interface utilisateur. Si cet indicateur n’est pas spécifié, cette fonction affiche un Assistant pour guider l’utilisateur tout au long du processus de signature. |
[in, optional] hwndParent
Handle de la fenêtre à utiliser comme parent de la boîte de dialogue créée par cette fonction. Ce paramètre est ignoré si l’indicateur CRYPTUI_WIZ_NO_UI est défini dans dwFlags.
[in, optional] pwszWizardTitle
Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le titre à utiliser dans la boîte de dialogue créée par cette fonction. Ce paramètre est ignoré si l’indicateur CRYPT_WIZ_NO_UI est défini dans dwFlags. Si ce paramètre a la valeur NULL, un titre par défaut est utilisé.
[in] pDigitalSignInfo
Pointeur vers une structure CRYPTUI_WIZ_DIGITAL_SIGN_INFO qui contient des informations sur le processus de signature.
[out, optional] ppSignContext
Pointeur vers un pointeur de structure CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT qui reçoit l’objet BLOB signé. Une fois cette structure terminée, vous devez libérer la mémoire en passant ce pointeur à la fonction CryptUIWizFreeDigitalSignContext . Ce paramètre peut être NULL si l’objet BLOB signé n’est pas nécessaire.
Valeur retournée
Si la fonction réussit, la valeur de retour est TRUE.
Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
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] |
| Plateforme cible | Windows |
| En-tête | cryptuiapi.h |
| Bibliothèque | Cryptui.lib |
| DLL | Cryptui.dll |