Метод IBindCtx::GetObjectParam (objidl.h)

Статья
08/25/2023

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

Синтаксис

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

Параметры

[in] pszKey

Искомый ключ строки контекста привязки. Сравнение ключевых строк учитывает регистр.

[out] ppunk

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

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

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае это E_FAIL.

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

Указатель, извлекаемый этим методом, должен быть ранее вставлен в таблицу с помощью метода IBindCtx::RegisterObjectParam .

Примечания к вызывающим абонентам

Объекты, использующие моникеры для поиска других объектов, могут вызывать этот метод, если операции привязки не удается получить конкретные сведения об ошибке. В зависимости от ошибки можно исправить ситуацию и повторить операцию привязки. Дополнительные сведения см. в разделе IBindCtx::RegisterObjectParam .

Реализации моникера могут вызывать этот метод для обработки ситуаций, когда вызывающий объект инициирует операцию привязки и запрашивает конкретные сведения. По соглашению разработчик должен использовать имена ключей, которые начинаются со строковой формы CLSID класса моникера. (См. функцию StringFromCLSID .)

Требования

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

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

IBindCtx

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