Compartilhar via


Função CryptXmlOpenToEncode (cryptxml.h)

Se a função CryptXmlOpenToEncode abrir uma assinatura digital XML para codificar e retornar um identificador do elemento Signature aberto. O identificador encapsula um contexto de documento com uma única estrutura CRYPT_XML_SIGNATURE e permanece aberto até que a função CryptXmlClose seja chamada.

Sintaxe

HRESULT CryptXmlOpenToEncode(
  [in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
                 DWORD                                  dwFlags,
  [in, optional] LPCWSTR                                wszId,
  [in]           const CRYPT_XML_PROPERTY               *rgProperty,
  [in]           ULONG                                  cProperty,
  [in, optional] const CRYPT_XML_BLOB                   *pEncoded,
  [optional]     HCRYPTXML                              *phSignature
);

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.
Nota 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, optional] wszId

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o atributo Id do elemento Signature . Se esse parâmetro for NULL, um novo GUID será gerado. Se esse parâmetro for uma cadeia de caracteres vazia, nenhum atributo de Id será produzido.

[in] rgProperty

Um ponteiro para uma matriz de estruturas de CRYPT_XML_PROPERTY que especificam propriedades adicionais.

[in] cProperty

O número de elementos na matriz apontada pelo parâmetro rgProperty .

[in, optional] pEncoded

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

[optional] phSignature

O identificador para o elemento Signature .

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