Função CryptXmlAddObject (cryptxml.h)

A função CryptXmlAddObject adiciona o elemento Object à Assinatura no Contexto do Documento aberto para codificação.

Sintaxe

HRESULT CryptXmlAddObject(
  [in]            HCRYPTXML                hSignatureOrObject,
                  DWORD                    dwFlags,
  [in, optional]  const CRYPT_XML_PROPERTY *rgProperty,
  [in]            ULONG                    cProperty,
  [in]            const CRYPT_XML_BLOB     *pEncoded,
  [out, optional] const CRYPT_XML_OBJECT   **ppObject
);

Parâmetros

[in] hSignatureOrObject

O identificador de uma Assinatura retornada pela função CryptXmlOpenToEncode ou o identificador de uma Referência retornada pela função CryptXmlCreateReference com o sinalizador CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT definido.

dwFlags

Especifica sinalizadores que controlam a maneira como o objeto é adicionado.

Os valores dwFlags definidos atualmente são mostrados na tabela a seguir.

Valor	Significado
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE	Quando definido, uma cópia na memória da parte XML é criada e incluída no elemento Object .

[in, optional] rgProperty

Um ponteiro para uma estrutura CRYPT_XML_PROPERTY que especifica propriedades adicionais usadas para decodificar o elemento Object .

[in] cProperty

O número de elementos na matriz apontada pela propriedade rgProperty .

[in] pEncoded

Um ponteiro para uma estrutura CRYPT_XML_BLOB que contém o elemento Object .

[out, optional] ppObject

Um ponteiro para um ponteiro para uma estrutura CRYPT_XML_OBJECT para receber a estrutura decodificada. Esse parâmetro deve ser NULL quando o parâmetro hSignatureOrObject contiver um identificador para o Objeto.

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.

Comentários

Quando o parâmetro hSignatureOrObject especifica um identificador para uma Referência retornada pela função CryptXmlCreateReference , o parâmetro pEncoded especifica o conteúdo XML incluído no nó Object após o elemento Manifest opcional. O ponteiro contido no parâmetro pEncoded deve ser válido até que a assinatura seja concluída. Caso contrário, use o sinalizador CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY para criar uma cópia na memória.

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