Función CryptXmlAddObject (cryptxml.h)

La función CryptXmlAddObject agrega el elemento Object a la firma en el contexto de documento abierto para codificar.

Sintaxis

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

Identificador de una firma devuelta por la función CryptXmlOpenToEncode o el identificador de una referencia devuelta por la función CryptXmlCreateReference con el conjunto de marcas de CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT .

dwFlags

Especifica marcas que controlan la manera en que se agrega el objeto.

Los valores dwFlags definidos actualmente se muestran en la tabla siguiente.

Valor	Significado
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE	Cuando se establece, se crea una copia en memoria del elemento XML y se incluye en el elemento Object .

[in, optional] rgProperty

Puntero a una estructura CRYPT_XML_PROPERTY que especifica propiedades adicionales usadas para descodificar el elemento Object .

[in] cProperty

Número de elementos de la matriz a los que apunta la propiedad rgProperty .

[in] pEncoded

Puntero a una estructura CRYPT_XML_BLOB que contiene el elemento Object .

[out, optional] ppObject

Puntero a un puntero a una estructura de CRYPT_XML_OBJECT para recibir la estructura descodificada. Este parámetro debe ser NULL cuando el parámetro hSignatureOrObject contiene un identificador para el objeto.

Valor devuelto

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

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

Comentarios

Cuando el parámetro hSignatureOrObject especifica un identificador para una referencia devuelta por la función CryptXmlCreateReference , el parámetro pEncoded especifica el contenido XML que se incluye en el nodo Object después del elemento Manifest opcional. El puntero contenido en el parámetro pEncoded debe ser válido hasta que se complete la firma. De lo contrario, use la marca CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY para crear una copia en memoria.

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