Поделиться через


Метод IXpsOMDictionary::GetAt (xpsobjectmodel.h)

Возвращает указатель интерфейса IXpsOMShareable и строку имени ключа записи по указанному индексу в словаре.

Синтаксис

HRESULT GetAt(
  [in]          UINT32          index,
  [out]         LPWSTR          *key,
  [out, retval] IXpsOMShareable **entry
);

Параметры

[in] index

Отсчитываемый от нуля индекс записи словаря, которую необходимо получить.

[out] key

Строка ключа, найденная в расположении, указанном индексом.

[out, retval] entry

Указатель интерфейса IXpsOMShareable , который находится в расположении, указанном индексом.

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

Если метод завершается успешно, он возвращает S_OK; В противном случае возвращается код ошибки HRESULT .

Комментарии

Указатели интерфейса, хранящиеся в словаре, обычно указывают на интерфейсы, такие как IXpsOMBrush и IXpsOMVisual, которые являются производными от интерфейса IXpsOMShareable . Чтобы определить тип интерфейса, вызовите метод IXpsOMShareable::GetType .

Этот метод выделяет память, используемую строкой, возвращаемой в ключе. Если ключ не имеет значение NULL, используйте функцию CoTaskMemFree , чтобы освободить память.

Требования

Требование Значение
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновление платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header xpsobjectmodel.h

См. также раздел

IXpsOMBrush

IXpsOMDictionary

IXpsOMShareable

IXpsOMVisual

XPS