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.

[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