Метод IXpsSignature::Verify (xpsdigitalsignature.h)

Статья
08/28/2023

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

Синтаксис

HRESULT Verify(
  [in]          const CERT_CONTEXT   *x509Certificate,
  [out, retval] XPS_SIGNATURE_STATUS *sigStatus
);

Параметры

[in] x509Certificate

Структура CERT_CONTEXT , содержащая сертификат X.509, который будет использоваться для проверки.

Если подпись не является неполной или несоответствующей, этот сертификат будет использоваться только для проверки того, что подписанные данные в пакете XPS нетронуты. Сертификат не будет использоваться для выполнения других проверок. Перед использованием сертификата приложение должно проверить цепочку доверия и любые другие требования.

[out, retval] sigStatus

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

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

Метод возвращает HRESULT. Возможные значения включают, помимо прочего, значения в следующей таблице. Возвращаемые значения, не перечисленные в этой таблице, см. в разделах Ошибки API цифровой подписи XPS и Ошибки документа XPS.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_POINTER	x509Certificate или sigStatus имеет значение NULL.
E_UNEXPECTED	Интерфейс не подключен к диспетчеру подписей.

Этот метод определяет состояние подписи в порядке, указанном в разделе 10.2.1.2 спецификации xml paper. Последовательность обнаружения выглядит следующим образом: несоответствующая, неполная, неработающая, сомнительная и, наконец, допустимая. Это означает, что если, например, сигнатура окажется несоответствующей, хэш-код не будет вычисляться, если сигнатура также нарушена.

Дополнительные сведения о различных типах состояний подписей, которые могут быть обнаружены с помощью этого метода, см. в разделе XPS_SIGNATURE_STATUS.

Требования


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