Função CryptXmlOpenToDecode (cryptxml.h)

  • Artigo

A função CryptXmlOpenToDecode abre uma assinatura digital XML para decodificar e retorna o identificador do contexto do documento que encapsula uma estrutura de CRYPT_XML_SIGNATURE . O contexto do documento pode incluir um ou mais elementos Signature .

Sintaxe

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

O identificador do mecanismo de cadeia de transformação. Se esse parâmetro for NULL, um mecanismo padrão será usado para aplicar transformações.

dwFlags

Um valor DWORD que controla quais extensões CryptXML são carregadas e se o XML é serializado. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
CRYPT_XML_FLAG_NO_SERIALIZE
0x80000000
 Inibir a serialização.
Importante Não defina esse sinalizador quando vários threads estiverem acessando um objeto CryptXml. A serialização garante a exclusão mútua quando dois ou mais threads tentam aceitar simultaneamente um objeto ou memória CryptXml.
 
CRYPT_XML_FLAG_DISABLE_EXTENSIONS
0x10000000
 Somente as implementações padrão para a assinatura e o resumo são usadas. Quando esse sinalizador é definido, nenhuma outra extensão registrada é carregada.

[in] rgProperty

Um ponteiro para uma matriz de estruturas de CRYPT_XML_PROPERTY que contêm propriedades adicionais.

cProperty

O número de itens na matriz apontado pelo parâmetro rgProperty .

[in] pEncoded

Um ponteiro para CRYPT_XML_BLOB estrutura que contém a assinatura a ser decodificada.

phCryptXml

O identificador de um objeto Document Context. Quando terminar de usar o identificador, solte-o passando-o para a função CryptXmlClose .

Retornar valor

Se a função for bem-sucedida, a função retornará zero.

Se a função falhar, ela retornará um valor HRESULT que indica o erro.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho cryptxml.h
Biblioteca Cryptxml.lib
DLL Cryptxml.dll