Método IObjectWithSite::GetSite (ocidl.h)

Recupera el sitio más reciente pasado mediante SetSite.

Sintaxis

HRESULT GetSite(
  [in]  REFIID riid,
  [out] void   **ppvSite
);

Parámetros

[in] riid

IiD del puntero de interfaz que se debe devolver en ppvSite.

[out] ppvSite

Dirección de la variable de puntero que recibe el puntero de interfaz solicitado en riid. Tras la devolución correcta, *ppvSite contiene el puntero de interfaz solicitado al sitio visto por última vez en SetSite. La interfaz específica devuelta depende del argumento riid . En esencia, los dos argumentos actúan de forma idéntica a los de QueryInterface. Si el puntero de interfaz adecuado está disponible, el objeto debe llamar a AddRef en ese puntero antes de devolverlo correctamente. Si no hay ningún sitio disponible o no se admite la interfaz solicitada, este método debe *ppvSite a NULL y devolver un código de error.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente. Otros posibles valores devueltos son los siguientes.

Código devuelto	Descripción
E_FAIL	No hay ningún sitio, en cuyo caso *ppvSite contiene NULL al devolver.
E_NOINTERFACE	Hay un sitio, pero no admite la interfaz solicitada por riid.

Comentarios

no se permite E_NOTIMPL. Cualquier objeto que implemente esta interfaz debe ser capaz de devolver el último sitio que se ve en IObjectWithSite::SetSite.

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

IObjectWithSite