CryptXmlCreateReference 函式 (cryptxml.h)

  • 發行項

CryptXmlCreateReference 函式會建立 XML 簽章的參考。

語法

HRESULT CryptXmlCreateReference(
  [in]           HCRYPTXML                 hCryptXml,
                 DWORD                     dwFlags,
  [in, optional] LPCWSTR                   wszId,
  [in, optional] LPCWSTR                   wszURI,
  [in, optional] LPCWSTR                   wszType,
  [in]           const CRYPT_XML_ALGORITHM *pDigestMethod,
                 ULONG                     cTransform,
  [in]           const CRYPT_XML_ALGORITHM *rgTransform,
  [out]          HCRYPTXML                 *phReference
);

參數

[in] hCryptXml

XML 簽章的句柄。

dwFlags

指定會影響參考建立方式的旗標。

下表顯示目前定義的 dwFlags 值。

值 意義
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT
0x00000001
 設定此旗標以建立 物件 節點，並將它新增至 Signature 元素。 對象節點的參考是在 SignedInfo 元素中建立的。

傳回的句柄是封裝 的 Object 節點，可用於 對 CryptXmlCreateReference 函式的後續呼叫，以在 指令清單 節點中建立參考。

[in, optional] wszId

Null 終止 Unicode 字串的指標，其中包含簽章之 Reference 元素的 ID 屬性值。 如果此參數為 NULL，則不會建立 ID 屬性。 如果此參數是空字串，則會建立具有空白值的 ID 屬性。

[in, optional] wszURI

Null 終止 Unicode 字串的指標，其中包含簽章之 Reference 元素的 URI 屬性值。 如果此參數是空字串，則會建立具有空白值的 URI 屬性。

[in, optional] wszType

Null 終止 Unicode 字串的指標，其中包含簽章之 Reference 元素之 Type 屬性的值。 處理引擎不會檢查或使用這個屬性。

[in] pDigestMethod

包含摘要方法 之CRYPT_XML_ALGORITHM 結構的指標。

cTransform

rgTransform 參數所指向之陣列中的元素數目。

[in] rgTransform

CRYPT_XML_ALGORITHM結構的已排序數位指標，其中包含在摘要計算之前套用至參考數據的轉換演算法。

[out] phReference

參考句柄的指標。

傳回值

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

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

規格需求

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