IXpsSignatureBlock：：CreateRequest 方法 (xpsdigitalsignature.h)

创建新的 IXpsSignatureRequest 接口，并将其添加到签名块。

语法

HRESULT CreateRequest(
  [in]          LPCWSTR              requestId,
  [out, retval] IXpsSignatureRequest **signatureRequest
);

[in] requestId

唯一标识签名块中的新签名请求的字符串。对于生成 ID 字符串的方法，请将此参数设置为 NULL。

[out, retval] signatureRequest

指向新 IXpsSignatureRequest 接口的指针。如果不需要访问新请求接口，则可以将此参数设置为 NULL。

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

返回代码	说明
S_OK	方法成功。
E_UNEXPECTED	接口未连接到签名管理器，或者 requestId 为 NULL 且无法生成唯一 ID 字符串。

新的签名请求必须具有唯一的请求 ID;没有两个请求可能具有相同的 ID 字符串。

创建新请求会将签名块标记为脏，并为 SignatureDefinitions 部件生成新内容。序列化 XPS 包时，新内容将覆盖 SignatureDefinitions 部分中以前的内容。