iOpcSignatureCustomObject：：GetXml 方法 (msopc.h)

發行項
03/05/2024

取得應用程式特定 Object 專案的 XML 標記。

語法

HRESULT GetXml(
  [out] UINT8  **xmlMarkup,
  [out] UINT32 *count
);

參數

[out] xmlMarkup

緩衝區的指標，其中包含 Object 專案的 XML 標記，並包含開頭和結尾 Object 標記。

在緩衝區中，XML 標記前面會加上對應於標記編碼的位元組順序標記。

支援的編碼和位元組順序標記值。

編碼	Description	位元組順序符號
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16，位元組由小到大	FF FE
UTF16BE	UTF-16， big endian	FE FF

如需具有位元組順序標記的緩衝區範例，請參閱一節。

[out] count

xmlMarkup 緩衝區大小的指標。

傳回值

方法會傳回 HRESULT。可能的值包括 (但不限於) 下表中的這些值。

傳回碼	描述
S_OK	此方法已成功。
E_POINTER	至少其中一個 xmlMarkup，且 count 參數為 NULL。

備註

這個方法會配置 xmlMarkup 中傳回之緩衝區所使用的記憶體。如果方法成功，請呼叫 CoTaskMemFree 函式以釋放記憶體。

您可以藉由取代簽章標記來新增、移除或修改簽章標記中的串行化應用程式特定 Object 元素。

若要取代簽章標記，請呼叫 IOpcDigitalSignatureManager：：ReplaceSignatureXml 方法。呼叫端必須確定新增、刪除或修改應用程式特定 Object 元素不會中斷簽章。

若要簽署應用程式特定的 Object 元素或該專案的子專案，請建立要簽署之 XML 項目的參考。呼叫 IOpcSignatureReferenceSet：：Create 方法，並將 referenceUri 參數值設定為 “#”，後面接著所參考專案的 Id 屬性值，以建立參考。例如，如果參考專案的 Id 屬性是 “Application”，請將 referenceUri 設定為 “#Application”。

下表顯示 xmlMarkup 緩衝區開頭包含 “<Object Id=”id1“/Object>”>< 的位元組順序標記：

緩衝區位元組索引	0	1	2	3	4	5	6	7	...
UTF8 值	EF	BB	BF	'<'	'O'	'b'	'j'	'e'	...
UTF16LE值	FF	FE	'<'	00	'O'	00	'b'	00	...

執行緒安全性

封裝物件不是安全線程。

如需詳細資訊，請參閱使用封裝 API 使用者入門。

規格需求

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