共用方式為

CryptXmlAddObject 函式 (cryptxml.h)

  • 發行項

CryptXmlAddObject 函式會將 Object 元素新增至開啟以供編碼之文件內容中的 Signature。

語法

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

參數

[in] hSignatureOrObject

CryptXmlOpenToEncode 函式所傳回之 Signature 的句柄，或是 CryptXmlCreateReference 函式所傳回之 Reference 的句柄，以及已設定CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT旗標。

dwFlags

指定旗標，控制加入物件的方式。

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

值 意義
CRYPT_XML_ADD_OBJECT_CREATE_REFERENCE
 設定時，會建立 XML 元件的記憶體內部複本，並包含在 Object 元素中。

[in, optional] rgProperty

CRYPT_XML_PROPERTY 結構的指標，指定用來譯碼 Object 元素的其他屬性。

[in] cProperty

rgProperty 屬性所指向之陣列中的元素數目。

[in] pEncoded

包含 Object 元素之CRYPT_XML_BLOB結構的指標。

[out, optional] ppObject

要接收譯碼結構的 CRYPT_XML_OBJECT 結構的指標。 當 hSignatureOrObject 參數包含 Object 的句柄時，此參數必須是 NULL。

傳回值

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

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

備註

當 hSignatureOrObject 參數指定 CryptXmlCreateReference 函式所傳回之 Reference 的句柄時，pEncoded 參數會指定選擇性指令清單項目之後包含在 Object 節點中的 XML 內容。 pEncoded 參數中包含的指標必須有效，直到簽章完成為止。 否則，請使用 CRYPT_XML_FLAG_ADD_OBJECT_CREATE_COPY 旗標來建立記憶體內部複本。

規格需求

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