Поделиться через


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

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

Синтаксис

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

Параметры

[out, retval] signatureMethod

Указатель на метод сигнатуры.

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

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

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

Комментарии

Этот метод выделяет память, используемую строкой, возвращаемой в signatureMethod. Если метод выполнен успешно, вызовите функцию CoTaskMemFree , чтобы освободить память.

Чтобы задать метод подписи перед созданием сигнатуры, вызовите метод IOpcSigningOptions::SetSignatureMethod .

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

Важно Перед созданием сигнатуры необходимо задать допустимый метод подписи путем вызова метода IOpcDigitalSignatureManager::Sign .
 
При создании сигнатуры она сериализуется как разметка подписи. Метод сигнатуры используется для вычисления значения в элементе SignatureValue в разметке сигнатуры.

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

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

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

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

Требования

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

См. также раздел

Основные интерфейсы упаковки

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

IOpcDigitalSignature

IOpcDigitalSignatureManager

IOpcSigningOptions

Разделы общих сведений

Руководство по программированию API упаковки

Справочник по API упаковки

Примеры API упаковки

Упаковка интерфейсов цифровой подписи

Интерфейсы упаковки

Справочные материалы