Метод IOpcDigitalSignatureManager::Validate (msopc.h)

Статья
02/29/2024

Проверяет указанную подпись пакета с помощью указанного сертификата.

Синтаксис

HRESULT Validate(
  [in]          IOpcDigitalSignature            *signature,
  [in]          const CERT_CONTEXT              *certificate,
  [out, retval] OPC_SIGNATURE_VALIDATION_RESULT *validationResult
);

Параметры

[in] signature

Указатель интерфейса IOpcDigitalSignature , представляющий проверяемую подпись.

[in] certificate

Указатель на структуру CERT_CONTEXT , содержащую сертификат, используемый для проверки подписи.

[out, retval] validationResult

Значение типа , описывающее результат проверка проверки.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	По крайней мере один из параметров signature, certificate и validationResult имеет значение NULL.

Этот метод не выполняет проверки безопасности для сертификата инфраструктуры открытых ключей X.509; вызывающий объект должен выполнить проверки на отзыв, срок действия, цепочку сертификатов и все остальные необходимые проверки.

Этот метод проверяет, что указанная подпись (подписанные сущности и разметка подписи) не была изменена с момента создания подписи, но не проверяет личность подписывающего.

Важно Вызывающий объект должен проверить удостоверение подписывателя.

Если в сигнатуре пакета есть ошибки, некоторые из этих ошибок могут быть недоступны до вызова этого метода.

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

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

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

Требования

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