Метод IBindCtx::GetObjectParam (objidl.h)
Извлекает указатель интерфейса на объект, связанный с указанным ключом в таблице указателей с ключом к строкам контекста привязки.
Синтаксис
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 |