Función CryptXmlOpenToDecode (cryptxml.h)

  • Artículo

La función CryptXmlOpenToDecode abre una firma digital XML para descodificar y devuelve el identificador del contexto del documento que encapsula una estructura CRYPT_XML_SIGNATURE . El contexto del documento puede incluir uno o varios elementos Signature .

Sintaxis

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
);

Parámetros

[in, optional] pConfig

Identificador del motor de cadena de transformación. Si este parámetro es NULL, se usará un motor predeterminado para aplicar transformaciones.

dwFlags

Valor DWORD que controla qué extensiones CryptXML se cargan y si se serializa el XML. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
CRYPT_XML_FLAG_NO_SERIALIZE
0x80000000
 Inhiba la serialización.
Importante No establezca esta marca cuando varios subprocesos accedan a un objeto CryptXml. La serialización garantiza la exclusión mutua cuando dos o más subprocesos intentan aceptar simultáneamente un objeto o memoria CryptXml.
 
CRYPT_XML_FLAG_DISABLE_EXTENSIONS
0x10000000
 Solo se usan implementaciones predeterminadas para la firma y el resumen. Cuando se establece esta marca, no se cargan otras extensiones registradas.

[in] rgProperty

Puntero a una matriz de estructuras CRYPT_XML_PROPERTY que contienen propiedades adicionales.

cProperty

Número de elementos de la matriz a los que apunta el parámetro rgProperty .

[in] pEncoded

Puntero a CRYPT_XML_BLOB estructura que contiene la firma que se va a descodificar.

phCryptXml

Identificador de un objeto Document Context. Cuando haya terminado de usar el identificador, suéltelo pasando a la función CryptXmlClose .

Valor devuelto

Si la función se realiza correctamente, la función devuelve cero.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado cryptxml.h
Library Cryptxml.lib
Archivo DLL Cryptxml.dll