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 中传递的缓冲区的开头包含字节顺序标记是可选的。

支持以下编码和字节顺序标记值：

编码	说明	字节顺序标记
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16， little endian	FF FE
UTF16BE	UTF-16，big endian	FE FF

[in] count

xmlMarkup 缓冲区的大小。

[out, retval] customObject

表示特定于应用程序的 Object 元素的新 IOpcSignatureCustomObject 接口指针。

如果不需要指向新接口的指针，此参数可以为 NULL 。

返回值

该方法返回 HRESULT。可能的值包括（但并不限于）下表中的项。

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	计数参数为 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