Expand Minimize

CryptUIWizDigitalSign function

[The CryptUIWizDigitalSign function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

The CryptUIWizDigitalSign function digitally signs a document or BLOB. The document or BLOB can be signed with or without user interaction.

Syntax


BOOL WINAPI CryptUIWizDigitalSign(
  _In_       DWORD dwFlags,
  _In_opt_   HWND hwndParent,
  _In_opt_   LPCWSTR pwszWizardTitle,
  _In_       PCCRYPTUI_WIZ_DIGITAL_SIGN_INFO pDigitalSignInfo,
  _Out_opt_  PCCRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT *ppSignContext
);

Parameters

dwFlags [in]

Contains flags that modify the behavior of the function. This can be zero or the following value.

ValueMeaning
CRYPTUI_WIZ_NO_UI
0x0001

This function will sign the document based on the information in the CRYPTUI_WIZ_DIGITAL_SIGN_INFO structure pointed to by the pDigitalSignInfo parameter without displaying any user interface. If this flag is not specified, this function will display a wizard to guide the user through the signing process.

 

hwndParent [in, optional]

The handle of the window to use as the parent of the dialog box that this function creates. This parameter is ignored if the CRYPTUI_WIZ_NO_UI flag is set in dwFlags.

pwszWizardTitle [in, optional]

A pointer to a null-terminated Unicode string that contains the title to use in the dialog box that this function creates. This parameter is ignored if the CRYPT_WIZ_NO_UI flag is set in dwFlags. If this parameter is NULL, a default title is used.

pDigitalSignInfo [in]

A pointer to a CRYPTUI_WIZ_DIGITAL_SIGN_INFO structure that contains information about the signing process.

ppSignContext [out, optional]

A pointer to a CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT structure pointer that receives the signed BLOB. When you have finished using this structure, you must free the memory by passing this pointer to the CryptUIWizFreeDigitalSignContext function. This parameter can be NULL if the signed BLOB is not needed.

Return value

If the function succeeds, the function returns nonzero.

If the function fails, it returns zero.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Cryptuiapi.h

Library

Cryptui.lib

DLL

Cryptui.dll

See also

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT
CRYPTUI_WIZ_DIGITAL_SIGN_INFO
CryptUIWizFreeDigitalSignContext

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.