Функция 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) |