IXpsSignatureRequest::GetRequestId 方法 (xpsdigitalsignature.h)

获取签名请求的唯一标识符。

语法

HRESULT GetRequestId(
  [out, retval] LPWSTR *requestId
);

参数

[out, retval] requestId

签名请求的唯一标识符。

返回值

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

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

注解

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

requestId 参数接收 SignatureDefinition 元素的 SpotID 属性的值。 SpotID 属性是必需的,应遵循 xs:ID (XML ID) 格式;但是,不会检查现有 SignatureDefinitions 部件是否符合建议的格式。 Windows Presentation Foundation (WPF) 应用程序生成的某些 XPS 文档的 ID 可能以数字开头。

要求

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

另请参阅

IXpsSignatureManager

IXpsSignatureRequest

XML 纸张规范

XPS 数字签名 API 错误

XPS 文档错误