IOpcSigningOptions::GetSignatureMethod 方法 (msopc.h)

获取用于计算和加密 SignedInfo 元素的哈希值的签名方法,该元素将序列化为签名的 SignatureValue 元素。

语法

HRESULT GetSignatureMethod(
  [out, retval] LPWSTR *signatureMethod
);

参数

[out, retval] signatureMethod

指向要使用的签名方法的指针,如果没有使用 SetSignatureMethod 方法设置方法,则为空字符串“”。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
E_POINTER
signatureMethod 参数为 NULL

注解

此方法分配 signatureMethod 中返回的字符串使用的内存。 如果方法成功,请调用 CoTaskMemFree 函数以释放内存。

若要设置签名方法,请调用 IOpcSigningOptions::SetSignatureMethod 方法。

若要在生成签名之前访问签名方法,请调用 IOpcSigningOptions::GetSignatureMethod。 若要在生成签名后访问签名方法,请调用 IOpcDigitalSignature::GetSignatureMethod 方法。

重要 在通过调用 IOpcDigitalSignatureManager::Sign 方法生成签名之前,必须设置有效的签名方法。
 
生成签名时,它会序列化为签名标记。 签名方法用于计算签名标记中 SignatureValue 元素中的值。

验证签名时,签名方法用于重新计算该值,并将重新计算的值与签名标记中 SignatureValue 元素中的值进行比较。

线程安全性

打包对象不是线程安全的。

有关详细信息,请参阅打包 API 的入门

要求

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

另请参阅

核心打包接口

使用打包 API 入门

IOpcDigitalSignature

IOpcDigitalSignatureManager

IOpcSigningOptions

概述

打包 API 编程指南

打包 API 参考

打包 API 示例

打包数字签名接口

打包接口

引用