Funzione CryptXmlOpenToDecode (cryptxml.h)

La funzione CryptXmlOpenToDecode apre una firma digitale XML da decodificare e restituisce l'handle del contesto del documento che incapsula una struttura CRYPT_XML_SIGNATURE . Il contesto del documento può includere uno o più elementi Signature .

Sintassi

HRESULT CryptXmlOpenToDecode(
  [in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
                 DWORD                                  dwFlags,
  [in]           const CRYPT_XML_PROPERTY               *rgProperty,
                 ULONG                                  cProperty,
  [in]           const CRYPT_XML_BLOB                   *pEncoded,
                 HCRYPTXML                              *phCryptXml
);

Parametri

[in, optional] pConfig

Handle del motore della catena di trasformazioni. Se questo parametro è NULL, verrà usato un motore predefinito per applicare le trasformazioni.

dwFlags

Valore DWORD che controlla quali estensioni CryptXML vengono caricate e se il codice XML viene serializzato. Questo parametro può avere uno dei valori seguenti.

[in] rgProperty

Puntatore a una matrice di strutture CRYPT_XML_PROPERTY che contengono proprietà aggiuntive.

cProperty

Numero di elementi nella matrice a cui punta il parametro rgProperty .

[in] pEncoded

Puntatore alla struttura CRYPT_XML_BLOB che contiene la firma da decodificare.

phCryptXml

Handle di un oggetto Document Context. Al termine dell'uso dell'handle, rilasciarlo passandolo alla funzione CryptXmlClose .

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.

Requisiti