CryptXmlOpenToDecode 函式 (cryptxml.h)

CryptXmlOpenToDecode 函式會開啟 XML 數位簽名來譯碼,並傳回封裝CRYPT_XML_SIGNATURE結構的檔內容句柄。 文件內容可以包含一或多個 Signature 元素。

語法

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

參數

[in, optional] pConfig

轉換鏈結引擎的句柄。 如果此參數為 NULL,則會使用預設引擎來套用轉換。

dwFlags

DWORD 值,可控制載入哪些 CryptXML 延伸模組,以及 XML 是否串行化。 此參數可以是下列其中一個值。

意義
CRYPT_XML_FLAG_NO_SERIALIZE
0x80000000
禁止串行化。
重要 當多個線程存取 CryptXml 物件時,請勿設定此旗標。 當兩個或多個線程嘗試同時接受 CryptXml 物件或記憶體時,串行化可確保互斥。
 
CRYPT_XML_FLAG_DISABLE_EXTENSIONS
0x10000000
只會使用簽章和摘要的預設實作。 設定此旗標時,不會載入其他已註冊的延伸模組。

[in] rgProperty

包含其他屬性之 CRYPT_XML_PROPERTY 結構的數位指標。

cProperty

rgProperty 參數所指向數位中的項目數。

[in] pEncoded

包含要譯碼之簽章的 CRYPT_XML_BLOB 結構的指標。

phCryptXml

Document Context 物件的句柄。 當您完成使用句柄時,請將它傳遞至 CryptXmlClose 函式來釋放它。

傳回值

如果函式成功,函式會傳回零。

如果函式失敗,它會傳回 HRESULT 值,指出錯誤。

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 cryptxml.h
程式庫 Cryptxml.lib
Dll Cryptxml.dll