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

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

  • Статья

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

Синтаксис

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

Параметры

[in] pszName

Отображаемое имя создаваемого объекта.

[in, optional] pBindOptions

Параметры привязки, используемые для создания моникера, создающего фактический объект. Дополнительные сведения см. в разделе BIND_OPTS. Этот параметр может принимать значение NULL.

[in] riid

Ссылка на идентификатор интерфейса, реализованного в создаваемом объекте.

[out] ppv

Адрес указателя на интерфейс, заданный riid для создаваемого объекта.

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

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

Код возврата Описание
S_OK
 Объект успешно создан.
MK_E_SYNTAX
 Параметр pszName не является отображаемым именем правильного формата.
MK_E_NOOBJECT
 Не удалось найти объект, идентифицированный этим моникером, или какой-либо объект, определяемый составным моникером, частью которого является этот моникер.
MK_E_EXCEEDEDDEADLINE
 Операция привязки не может быть завершена в течение срока, указанного структурой BIND_OPTS , переданной в pBindOptions.
MK_E_CONNECTMANUALLY
 Операция привязки требует помощи от конечного пользователя. Наиболее распространенные причины для возврата этого значения заключается в том, что требуется пароль или требуется подключить дискету.
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED
 Был найден промежуточный объект, но он не поддерживал интерфейс, необходимый для выполнения операции привязки. Например, моникер элемента возвращает это значение, если его контейнер не поддерживает интерфейс IOleItemContainer .

Комментарии

CoGetObject инкапсулирует вызовы функций библиотеки COM CreateBindCtx, MkParseDisplayName и IMoniker::BindToObject.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Профессиональная [классические приложения | Приложения UWP]
Минимальная версия сервера Windows 2000 Server [классические приложения | Приложения UWP]
Целевая платформа Windows
Header objbase.h
Библиотека Ole32.lib
DLL Ole32.dll

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

BIND_OPTS