IXpsSignatureRequest::GetIntent 方法 (xpsdigitalsignature.h)

设置描述签名意向或含义的字符串。

语法

HRESULT GetIntent(
  [out, retval] LPWSTR *intent
);

参数

[out, retval] intent

签名者要对其签名的签名意向协议。

返回值

该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的返回值,请参阅 XPS 数字签名 API 错误XPS 文档错误

返回代码 说明
S_OK
方法成功。
E_POINTER
意向NULL
E_UNEXPECTED
接口未连接到签名管理器。

注解

签名意向字符串描述签名对签名者的意义。 例如,对于签名意向字符串“我已阅读并同意此文档的内容”,数字签名的存在意味着签名者已阅读并同意文档的内容。

此方法分配 意向中返回的字符串使用的内存。 如果 intent 不为 NULL,请使用 CoTaskMemFree 函数释放内存。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 xpsdigitalsignature.h

另请参阅

IXpsSignatureManager

IXpsSignatureRequest

XML 纸张规范

XPS 数字签名 API 错误

XPS 文档错误