CryptUIWizDigitalSign 函数 (cryptuiapi.h)

[ CryptUIWizDigitalSign 函数可用于“要求”部分中指定的操作系统。 它在后续版本中可能已更改或不可用。]

CryptUIWizDigitalSign 函数对文档或 BLOB 进行数字签名。 无论是否用户交互,都可以对文档或 BLOB 进行签名。

语法

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
);

参数

[in] dwFlags

包含修改函数行为的标志。 这可以是零或以下值。

含义
CRYPTUI_WIZ_NO_UI
0x0001
此函数将根据 pDigitalSignInfo 参数指向的 CRYPTUI_WIZ_DIGITAL_SIGN_INFO 结构中的信息对文档进行签名,而不显示任何用户界面。 如果未指定此标志,此函数将显示一个向导,指导用户完成签名过程。

[in, optional] hwndParent

要用作此函数创建的对话框的父级的窗口的句柄。 如果在 dwFlags 中设置了CRYPTUI_WIZ_NO_UI标志,则忽略此参数。

[in, optional] pwszWizardTitle

指向以 null 结尾的 Unicode 字符串的指针,该字符串包含要在此函数创建的对话框中使用的标题。 如果在 dwFlags 中设置了CRYPT_WIZ_NO_UI标志,则忽略此参数。 如果此参数为 NULL,则使用默认标题。

[in] pDigitalSignInfo

指向包含签名过程相关信息 的 CRYPTUI_WIZ_DIGITAL_SIGN_INFO 结构的指针。

[out, optional] ppSignContext

指向接收已签名 BLOB 的CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT 结构指针的指针。 使用此结构后,必须将此指针传递给 CryptUIWizFreeDigitalSignContext 函数来释放内存。 如果不需要签名的 BLOB,此参数可以为 NULL

返回值

如果函数成功,则返回值为 TRUE

如果函数失败,则返回值为 FALSE。 有关扩展的错误信息,请调用 GetLastError

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 cryptuiapi.h
Library Cryptui.lib
DLL Cryptui.dll

另请参阅

CRYPTUI_WIZ_DIGITAL_SIGN_CONTEXT

CRYPTUI_WIZ_DIGITAL_SIGN_INFO

CryptUIWizFreeDigitalSignContext