Метод IOpcSigningOptions::SetSignatureMethod (msopc.h)

Статья
02/29/2024

Задает метод подписи, используемый для вычисления и шифрования хэш-значения элемента SignedInfo , который будет содержаться в элементе SignatureValue подписи.

Синтаксис

HRESULT SetSignatureMethod(
  [in] LPCWSTR signatureMethod
);

Параметры

[in] signatureMethod

Используемый метод сигнатуры.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Параметр signatureMethod имеет значение NULL.

Чтобы получить доступ к методу подписи перед созданием подписи, вызовите метод IOpcSigningOptions::GetSignatureMethod. Чтобы получить доступ к методу подписи после создания сигнатуры, вызовите метод IOpcDigitalSignature::GetSignatureMethod .

Важно Перед созданием сигнатуры необходимо задать допустимый метод подписи путем вызова метода IOpcDigitalSignatureManager::Sign .

При создании сигнатуры она сериализуется как разметка подписи. Метод сигнатуры используется для вычисления значения в элементе SignatureValue в разметке сигнатуры.

При проверке сигнатуры метод сигнатуры используется для повторного вычисления этого значения, а пересчитаемое значение сравнивается со значением в элементе SignatureValue в разметке подписи.

Потокобезопасность

Объекты упаковки не являются потокобезопасны.

Дополнительные сведения см. в статье начало работы с помощью API упаковки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	msopc.h