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.

Valore	Significato
CRYPT_XML_FLAG_NO_SERIALIZE 0x80000000	Inibire la serializzazione. Importante Non impostare questo flag quando più thread accedono a un oggetto CryptXml. La serializzazione garantisce l'esclusione reciproca quando due o più thread tentano di accettare simultaneamente un oggetto o una memoria CryptXml.
CRYPT_XML_FLAG_DISABLE_EXTENSIONS 0x10000000	Vengono usate solo le implementazioni predefinite per la firma e il digest. Quando questo flag è impostato, non vengono caricate altre estensioni registrate.

[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

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