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

  • Статья

Функция CryptXmlOpenToDecode открывает цифровую подпись XML для декодирования и возвращает дескриптор контекста документа, который инкапсулирует CRYPT_XML_SIGNATURE структуру. Контекст документа может включать один или несколько элементов Signature .

Синтаксис

HRESULT CryptXmlOpenToDecode(
  [in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
                 DWORD                                  dwFlags,
  [in]           const CRYPT_XML_PROPERTY               *rgProperty,
                 ULONG                                  cProperty,
  [in]           const CRYPT_XML_BLOB                   *pEncoded,
                 HCRYPTXML                              *phCryptXml
);

Параметры

[in, optional] pConfig

Дескриптор обработчика цепочки преобразования. Если этот параметр имеет значение NULL, то для применения преобразований будет использоваться обработчик по умолчанию.

dwFlags

Значение DWORD , определяющее загрузку расширений CryptXML и сериализацию XML. Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
CRYPT_XML_FLAG_NO_SERIALIZE
0x80000000
 Запрет сериализации.
Важно Не устанавливайте этот флаг, если несколько потоков обращаются к объекту CryptXml. Сериализация обеспечивает взаимное исключение, когда два или более потоков пытаются одновременно принять объект или память CryptXml.
 
CRYPT_XML_FLAG_DISABLE_EXTENSIONS
0x10000000
 Используются только реализации по умолчанию для подписи и дайджеста. Если этот флаг установлен, другие зарегистрированные расширения не загружаются.

[in] rgProperty

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

cProperty

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

[in] pEncoded

Указатель на CRYPT_XML_BLOB структуру, содержащую декодированную сигнатуру.

phCryptXml

Дескриптор объекта контекста документа. Завершив использование дескриптора, отпустите его, передав его в функцию CryptXmlClose .

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

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

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

Требования

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