Método IBindCtx::GetObjectParam (objidl.h)

  • Artículo

Recupera un puntero de interfaz al objeto asociado a la clave especificada en la tabla de punteros con clave de cadena del contexto de enlace.

Sintaxis

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

Parámetros

[in] pszKey

Clave de cadena de contexto de enlace que se va a buscar. La comparación de cadenas de clave distingue mayúsculas de minúsculas.

[out] ppunk

Dirección de una variable de puntero IUnknown* que recibe el puntero de interfaz al objeto asociado a pszKey. Cuando se ejecuta correctamente, la implementación llama a AddRef en *ppunk. Es responsabilidad del autor de la llamada llamar a Release. Si se produce un error, la implementación establece *ppunk en NULL.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto se S_OK. De lo contrario, es E_FAIL.

Comentarios

Un contexto de enlace mantiene una tabla de punteros de interfaz, cada uno asociado a una clave de cadena. Esto permite la comunicación entre una implementación de moniker y el autor de la llamada que inició la operación de enlace. Una entidad puede almacenar un puntero de interfaz bajo una cadena conocida para ambas partes para que la otra parte pueda recuperarla más adelante del contexto de enlace.

El puntero que recupera este método debe haberse insertado previamente en la tabla mediante el método IBindCtx::RegisterObjectParam .

Notas a los autores de llamadas

Los objetos que usan monikers para localizar otros objetos pueden llamar a este método cuando una operación de enlace no puede obtener información específica sobre el error que se produjo. Dependiendo del error, puede ser posible corregir la situación y volver a intentar la operación de enlace. Consulte IBindCtx::RegisterObjectParam para obtener más información.

Las implementaciones de Moniker pueden llamar a este método para controlar situaciones en las que un llamador inicia una operación de enlace y solicita información específica. Por convención, el implementador debe usar nombres de clave que comiencen con la forma de cadena del CLSID de una clase de moniker. (Vea la función StringFromCLSID ).

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado objidl.h

Consulte también

IBindCtx