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

Статья
08/25/2023

Возвращает объект part, представляющий указанную часть в наборе.

Синтаксис

HRESULT GetPart(
  [in]          IOpcPartUri *name,
  [out, retval] IOpcPart    **part
);

Параметры

[in] name

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

[out, retval] part

Указатель на IOpcPart объекта part, представляющего часть с указанным именем части.

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

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

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

Чтобы получить указатель интерфейса IOpcPart объекта part, представляющего определенную часть, вызовите метод PartExists и передайте имя части, чтобы убедиться, что часть представлена в наборе. Если это так, вызовите метод GetPart и передайте имя части, чтобы получить указатель интерфейса IOpcPart .

Если объект URI части представляет имя части части Relationships, этот метод завершится ошибкой, так как части Relationships не включены в набор.

Интерфейс IOpcPart предоставляет доступ к свойствам части. Дополнительные сведения об этих свойствах см. в разделах Общие сведения о частях и IOpcPart.

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

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

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

Требования

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