CryptUIWizDigitalSign, fonction (cryptuiapi.h)

  • Article

[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
CRYPTUI_WIZ_NO_UI
0x0001
 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 fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne zéro.

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

Voir aussi

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext