Función CryptXmlOpenToEncode (cryptxml.h)

Si la función CryptXmlOpenToEncode abre una firma digital XML para codificar y devuelve un identificador del elemento Signature abierto. El identificador encapsula un contexto de documento con una única estructura de CRYPT_XML_SIGNATURE y permanece abierto hasta que se llama a la función CryptXmlClose .

Sintaxis

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

Identificador del motor de cadena de transformación. Si este parámetro es NULL, se usa un motor predeterminado para aplicar transformaciones.

dwFlags

Valor DWORD que controla qué extensiones CryptXML se cargan y si el XML se serializa. Este parámetro puede ser uno de los valores siguientes.

[in, optional] wszId

Puntero a una cadena Unicode terminada en null que contiene el atributo Id del elemento Signature . Si este parámetro es NULL, se genera un nuevo GUID. Si este parámetro es una cadena vacía, no se genera ningún atributo Id .

[in] rgProperty

Puntero a una matriz de estructuras de CRYPT_XML_PROPERTY que especifican propiedades adicionales.

[in] cProperty

Número de elementos de la matriz a los que apunta el parámetro rgProperty .

[in, optional] pEncoded

Puntero a una estructura CRYPT_XML_BLOB que contiene la firma que se va a codificar.

[optional] phSignature

Identificador del elemento Signature .

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.

Requisitos