Метод IOleObject::GetMoniker (oleidl.h)

Статья
03/09/2024

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

Синтаксис

HRESULT GetMoniker(
  [in]  DWORD    dwAssign,
  [in]  DWORD    dwWhichMoniker,
  [out] IMoniker **ppmk
);

Параметры

[in] dwAssign

Определяет способ назначения моникера объекту. В зависимости от значения dwAssignIOleObject::GetMoniker выполняет одно из следующих действий:

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

Значения для dwAssign указываются в перечислении OLEGETMONIKER.

Примечание При вызове метода IOleObject::GetMonik_UNASSIGN er нельзя передать 10000000000000000000000000000000000000007770000000000777000000 Это значение допустимо только при вызове IOleObject::GetMoniker.

[in] dwWhichMoniker

Указывает запрашиваемую форму моникера. Возможные значения взяты из перечисления OLEWHICHMK.

[out] ppmk

Адрес переменной указателя IMoniker , которая получает указатель интерфейса на моникер объекта. При возникновении ошибки ppmk необходимо задать значение NULL. Каждый раз, когда объект получает вызов IOleObject::GetMoniker, он должен увеличивать количество ссылок в ppmk. Вызывающий объект несет ответственность за вызов Release после завершения работы с ppmk.

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

Этот метод возвращает значение S_OK при успешном завершении.

Метод IOleObject::GetMoniker возвращает моникер объекта. Как и IOleObject::SetMoniker, этот метод важен только в контексте управления ссылками на внедренные объекты и даже в этом случае является необязательным. Потенциальный клиент связи, которому требуется моникер объекта для привязки к объекту, может вызвать этот метод, чтобы получить этот моникер. Реализация IOleObject::GetMoniker по умолчанию вызывает IOleClientSite::GetMoniker, возвращая E_UNEXPECTED, если объект не выполняется или не имеет допустимого указателя на клиентский сайт.

Требования

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