Функция CreatePointerMoniker (objbase.h)

Создает моникер указателя на основе указателя на объект .

Синтаксис

HRESULT CreatePointerMoniker(
  [in, optional] LPUNKNOWN punk,
  [out]          LPMONIKER *ppmk
);

Параметры

[in, optional] punk

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

[out] ppmk

Адрес переменной указателя IMoniker*, которая получает указатель интерфейса на новый моникер указателя. При успешном выполнении функция вызывает AddRef для моникера, а вызывающий объект отвечает за вызов Release. При возникновении ошибки возвращаемый указатель интерфейса имеет значение NULL .

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

Эта функция может возвращать стандартные возвращаемые значения E_OUTOFMEMORY, E_UNEXPECTED и S_OK.

Комментарии

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

Моникеры указателей обычно не используются, поэтому эта функция не часто вызывается.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header objbase.h
Библиотека Ole32.lib
DLL Ole32.dll
Набор API ext-ms-win-com-ole32-l1-1-0 (появилось в Windows 8)

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

IMoniker