Windows Dev Center

EN
Ce contenu n’est pas disponible dans votre langue. Voici la version anglaise.

CryptXmlAddObject function

The CryptXmlAddObject function adds the Object element to the Signature in the Document Context opened for encoding.

Syntax


HRESULT WINAPI CryptXmlAddObject(
  _In_            HCRYPTXML          hSignatureOrObject,
                  DWORD              dwFlags,
  _In_opt_  const CRYPT_XML_PROPERTY *rgProperty,
  _In_            ULONG              cProperty,
  _In_      const PCRYPT_XML_BLOB    pEncoded,
  _Out_opt_ const CRYPT_XML_OBJECT   **ppObject
);

Parameters

hSignatureOrObject [in]

The handle of a Signature returned by the CryptXmlOpenToEncode function or the handle of a Reference returned by the CryptXmlCreateReference function with the CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT flag set.

dwFlags

Specifies flags that control the manner in which the object is added.

Currently defined dwFlags values are shown in the following table .

ValueMeaning
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE

When set, an in-memory copy of the XML part is created and included in the Object element.

 

rgProperty [in, optional]

A pointer to a CRYPT_XML_PROPERTY structure that specifies additional properties used to decode the Object element.

cProperty [in]

The number of elements in the array pointed to by the rgProperty property.

pEncoded [in]

A pointer to a CRYPT_XML_BLOB structure that contains the Object element.

ppObject [out, optional]

A pointer to a pointer to a CRYPT_XML_OBJECT structure to receive the decoded structure. This parameter must be NULL when the hSignatureOrObject parameter contains a handle to the Object.

Return value

If the function succeeds, the function returns zero.

If the function fails, it returns an HRESULT value that indicates the error.

Remarks

When the hSignatureOrObject parameter specifies a handle to a Reference returned by the CryptXmlCreateReference function, the pEncoded parameter specifies XML content that is included in the Object node after the optional Manifest element. The pointer contained in the pEncoded parameter must be valid until the signature is complete. Otherwise, use the CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY flag to create an in-memory copy.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Cryptxml.h

Library

Cryptxml.lib

DLL

Cryptxml.dll

 

 

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft