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
包含修改函数行为的标志。 这可以是零或以下值。
值 | 含义 |
---|---|
|
此函数将根据 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 |