Метод IOpcSignatureCustomObjectSet::Create (msopc.h)

Статья
08/25/2023

Создает указатель интерфейса IOpcSignatureCustomObject для представления элемента Object приложения в сигнатуре и добавляет новый интерфейс в набор.

Синтаксис

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

Параметры

[in] xmlMarkup

Буфер, содержащий разметку XML для представляемого элемента Object .

Эта xml-разметка должна включать открывающий и закрывающий теги /Object .

Кодирование разметки, содержащейся в xmlMarkup , будет выведено. Добавление метки порядка байтов в начало буфера, переданного в xmlMarkup , является необязательным.

Поддерживаются следующие кодировки и значения меток порядка байтов :

Кодирование	Описание	Метка порядка байтов
UTF8	UTF-8	EF BB BF
UTF16LE	UTF-16, маленький эндиан	FF FE
UTF16BE	UTF-16, большой эндиан	FE FF

[in] count

Размер буфера xmlMarkup .

[out, retval] customObject

Новый указатель интерфейса IOpcSignatureCustomObject , представляющий элемент Object для конкретного приложения.

Этот параметр может иметь значение NULL , если указатель на новый интерфейс не требуется.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Параметр count равен 0. Параметру xmlMarkup необходимо передать допустимую разметку XML.
E_POINTER	Параметр xmlMarkup имеет значение NULL.

Указатель интерфейса IOpcSignatureCustomObject предоставляет доступ к XML-разметке элемента Object , который он представляет. Чтобы получить доступ к XML-разметке элемента Object , вызовите метод IOpcSignatureCustomObject::GetXml .

Когда создается указатель интерфейса IOpcSignatureCustomObject и добавляется в набор, объект , который он представляет, сохраняется при сохранении пакета.

Потокобезопасность

Объекты упаковки не являются потокобезопасны.

Дополнительные сведения см. в статье начало работы с помощью API упаковки.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	msopc.h