Метод IOpcPartSet::D eletePart (msopc.h)

Статья
03/05/2024

Удаляет указатель интерфейса IOpcPart указанного объекта part из набора.

Синтаксис

HRESULT DeletePart(
  [in] IOpcPartUri *name
);

Параметры

[in] name

Указатель на интерфейс IOpcPartUri объекта URI части, который представляет имя части.

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

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

Возвращаемый код/значение	Описание
S_OK	Метод выполнен успешно.
E_POINTER	Параметр name имеет значение NULL.
OPC_E_NO_SUCH_PART 0x80510018	Указанная часть не существует.
Ошибка потребления пакета	Код ошибки HRESULT из группы ошибок потребления пакетов.
Ошибка URI части	Код ошибки HRESULT из группы ошибок URI части.

При удалении указателя интерфейса IOpcPart из набора часть, которую он представляет, не сериализуется при сериализации пакета. Кроме того, если представленная часть является источником одной или нескольких связей, эти связи не сохраняются вместе с пакетом при записи объекта пакета.

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

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

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

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

Требования

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