Функция CryptXmlCreateReference (cryptxml.h)

Статья
02/26/2024

Функция CryptXmlCreateReference создает ссылку на XML-сигнатуру.

Синтаксис

HRESULT CryptXmlCreateReference(
  [in]           HCRYPTXML                 hCryptXml,
                 DWORD                     dwFlags,
  [in, optional] LPCWSTR                   wszId,
  [in, optional] LPCWSTR                   wszURI,
  [in, optional] LPCWSTR                   wszType,
  [in]           const CRYPT_XML_ALGORITHM *pDigestMethod,
                 ULONG                     cTransform,
  [in]           const CRYPT_XML_ALGORITHM *rgTransform,
  [out]          HCRYPTXML                 *phReference
);

Параметры

[in] hCryptXml

Дескриптор XML-подписи.

dwFlags

Задает флаги, влияющие на способ создания ссылки.

В следующей таблице показаны текущие значения dwFlags .

Значение	Значение
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT 0x00000001	Установите этот флаг, чтобы создать узел Object и добавить его в элемент Signature . Ссылка на узел Object создается в элементе SignedInfo . Возвращаемый дескриптор является инкапсулированным узлом Object и может использоваться в последующих вызовах функции CryptXmlCreateReference для создания ссылок в узле манифеста .

Значение

CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT
0x00000001

Установите этот флаг, чтобы создать узел Object и добавить его в элемент Signature . Ссылка на узел Object создается в элементе SignedInfo .

Возвращаемый дескриптор является инкапсулированным узлом Object и может использоваться в последующих вызовах функции CryptXmlCreateReference для создания ссылок в узле манифеста .

[in, optional] wszId

Указатель на строку Юникода, завершающуюся null, которая содержит значение атрибута ID элемента Reference сигнатуры. Если этот параметр имеет значение NULL, то атрибут ID не создается. Если этот параметр является пустой строкой, создается атрибут ID с пустым значением.

[in, optional] wszURI

Указатель на строку Юникода, завершающуюся null, которая содержит значение атрибута URI элемента Reference сигнатуры. Если этот параметр является пустой строкой, создается атрибут URI с пустым значением.

[in, optional] wszType

Указатель на строку Юникода, завершающуюся null, которая содержит значение атрибута Type элемента Reference сигнатуры. Обработчик обработки не проверка и не использует этот атрибут.

[in] pDigestMethod

Указатель на CRYPT_XML_ALGORITHM структуру, содержащую метод дайджеста.

cTransform

Количество элементов в массиве, на который указывает параметр rgTransform .

[in] rgTransform

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

[out] phReference

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

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

Если функция выполнена успешно, функция возвращает ноль.

Если функция завершается сбоем, она возвращает значение HRESULT , указывающее на ошибку.

Требования

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

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