Метод IOpcRelationship::GetId (msopc.h)
Возвращает уникальный идентификатор связи.
Синтаксис
HRESULT GetId(
[out, retval] LPWSTR *relationshipIdentifier
);
Параметры
[out, retval] relationshipIdentifier
Идентификатор связи.
Идентификатор связи является произвольным и локальным по отношению к пакету и, следовательно, .
Допустимые идентификаторы соответствуют ограничениям для xsd:ID, которые описаны в разделе 3.3.8 Идентификатор рекомендации W3C, схема XML, часть 2. Типы данных второго выпуска (http://www.w3.org/TR/xmlschema-2/#ID).
Возвращаемое значение
Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Метод выполнен успешно. |
|
Параметр relationshipIdentifier имеет значение NULL. |
Комментарии
Идентификатор связи не полезен для поиска связей, так как он является произвольным и локальным для пакета.
Окончательный способ найти интересующую вас часть — использовать тип связи.
Поиск части требует нескольких шагов. Подробные сведения о поиске части см. в разделе Поиск части основных свойств.
Этот метод выделяет память, используемую строкой, возвращаемой в relationshipIdentifier. Если метод выполнен успешно, вызовите функцию CoTaskMemFree , чтобы освободить память.
Дополнительные сведения о связях см. в разделах Open Packaging Conventions Fundamentals и ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).
Потокобезопасность
Объекты упаковки не являются потокобезопасны.
Дополнительные сведения см. в начало работы с API упаковки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Целевая платформа | Windows |
| Header | msopc.h |
См. также раздел
Внешние ресурсы
Поиск части "Основные свойства"
начало работы с помощью API упаковки
Основы открытых соглашений об упаковке
Разделы общих сведений
Справочные материалы
Рекомендация W3C, схема XML, часть 2. Типы данных Second Edition