IOpcSignatureCustomObjectSet：：Create 方法 (msopc.h)

發行項
02/29/2024

建立 IOpcSignatureCustomObject 介面指標，以代表簽章中的應用程式特定 Object 元素，並將新介面新增至集合。

語法

HRESULT Create(
  [in]          const UINT8               *xmlMarkup,
  [in]          UINT32                    count,
  [out, retval] IOpcSignatureCustomObject **customObject
);

參數

[in] xmlMarkup

緩衝區，包含要表示之 Object 專案的 XML 標記。

這個 XML 標記必須包含開頭 的 Object 和結尾 /Object 標記。

會推斷 xmlMarkup 中所含標記的編碼方式。在 xmlMarkup 中傳遞的緩衝區開頭包含位元組順序標記是選擇性的。

支援下列編碼方式和位元組順序標記值：

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

[in] count

xmlMarkup 緩衝區的大小。

[out, retval] customObject

代表應用程式特定 Object 元素的新 IOpcSignatureCustomObject 介面指標。

如果不需要新介面的指標，此參數可以是 NULL 。

傳回值

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

傳回碼	描述
S_OK	此方法已成功。
E_INVALIDARG	count 參數為 0。 xmlMarkup 參數必須傳遞有效的 XML 標記。
E_POINTER	xmlMarkup 參數為 NULL。

備註

IOpcSignatureCustomObject 介面指標可讓您存取它所代表之 Object 專案的 XML 標記。若要存取 Object 專案的 XML 標記，請呼叫 IOpcSignatureCustomObject：：GetXml 方法。

建立 IOpcSignatureCustomObject 介面指標並新增至集合時 ，它會在 儲存封裝時儲存它所代表的物件。

執行緒安全性

封裝物件不是安全線程。

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

規格需求

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