Funzione CryptXmlAddObject (cryptxml.h)

  • Articolo

La funzione CryptXmlAddObject aggiunge l'elemento Object alla firma nel contesto documento aperto per la codifica.

Sintassi

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
);

Parametri

[in] hSignatureOrObject

Handle di una firma restituita dalla funzione CryptXmlOpenToEncode o dall'handle di un riferimento restituito dalla funzione CryptXmlCreateReference con il flag di CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT impostato.

dwFlags

Specifica i flag che controllano il modo in cui viene aggiunto l'oggetto.

I valori dwFlags attualmente definiti sono visualizzati nella tabella seguente.

Valore Significato
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE
 Se impostato, viene creata una copia in memoria della parte XML e inclusa nell'elemento Object .

[in, optional] rgProperty

Puntatore a una struttura CRYPT_XML_PROPERTY che specifica proprietà aggiuntive usate per decodificare l'elemento Object .

[in] cProperty

Numero di elementi nella matrice a cui punta la proprietà rgProperty .

[in] pEncoded

Puntatore a una struttura CRYPT_XML_BLOB contenente l'elemento Object .

[out, optional] ppObject

Puntatore a un puntatore a una struttura CRYPT_XML_OBJECT per ricevere la struttura decodificata. Questo parametro deve essere NULL quando il parametro hSignatureOrObject contiene un handle per l'oggetto.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce zero.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore.

Commenti

Quando il parametro hSignatureOrObject specifica un handle a un riferimento restituito dalla funzione CryptXmlCreateReference , il parametro pEncoded specifica il contenuto XML incluso nel nodo Object dopo l'elemento Manifesto facoltativo. Il puntatore contenuto nel parametro pEncoded deve essere valido fino al completamento della firma. In caso contrario, usare il flag CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY per creare una copia in memoria.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione cryptxml.h
Libreria Cryptxml.lib
DLL Cryptxml.dll