Método IOleControlSite::GetExtendedControl (ocidl.h)

  • Artículo

Recupera un puntero IDispatch al control extendido que el contenedor usa para encapsular el control real.

Sintaxis

HRESULT GetExtendedControl(
  [out] IDispatch **ppDisp
);

Parámetros

[out] ppDisp

Puntero a una variable de puntero IDispatch que recibe el puntero de interfaz al control extendido. Si se produce un error, la implementación debe establecer *ppDisp en NULL. Si se ejecuta correctamente, el autor de la llamada es responsable de llamar a Release cuando *ppDisp ya no es necesario.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
E_NOTIMPL
 El contenedor no implementa controles extendidos.
E_POINTER
 La dirección de ppDisp o *ppDisp no es válida. Por ejemplo, puede ser NULL.

Comentarios

Este método proporciona al control real acceso a las propiedades y métodos que mantiene el contenedor en el control extendido. De lo contrario, estas propiedades y métodos no serían accesibles para el control.

Notas a los autores de llamadas

El puntero devuelto es responsabilidad del autor de la llamada, que debe liberarlo cuando ya no sea necesario.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IOleControlSite