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

Статья
03/05/2024

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

Синтаксис

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

Параметры

[out, retval] signatureMethod

Указатель на используемый метод сигнатуры или пустую строку "", если метод не был задан с помощью метода SetSignatureMethod .

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

Метод возвращает 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