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


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

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

Синтаксис

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

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

CreateItemMoniker

IOleClientSite::GetMoniker

IOleObject

IOleObject::SetMoniker

ОЛЕГЕТМОНИКЕР

OLEWHICHMK