Метод IDirectManipulationContent::GetTag (directmanipulation.h)

Статья
02/29/2024

Извлекает объект тега, заданный для этого содержимого.

Синтаксис

HRESULT GetTag(
  [in]            REFIID riid,
  [out, optional] void   **object,
  [out, optional] UINT32 *id
);

Параметры

[in] riid

Ссылка на идентификатор используемого интерфейса. Объект тега обычно реализует этот интерфейс.

[out, optional] object

Объект тега.

[out, optional] id

Часть идентификатора тега.

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

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

GetTag и SetTag полезны для связывания внешнего COM-объекта с содержимым без внешнего сопоставления между ними. Их также можно использовать для передачи информации в обратные вызовы, созданные для содержимого.

GetTag запрашивает значение тега для указанного интерфейса и возвращает указатель на этот интерфейс.

Тег — это связывание целочисленного идентификатора (id) с объектом (объектом COM). Он может использоваться приложением для идентификации движения. Параметры являются необязательными, поэтому метод может возвращать обе части тега, часть идентификатора или объект тега.

Примеры

В следующем примере показан синтаксис этого метода.

IUnknown* pObject;
UINT32 id;

HRESULT hr = pContent->GetTag(IID_PPV_ARGS(&pObject), &id);

Требования

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

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

IDirectManipulationContent

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