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

  • Artículo

Permite que un contenedor pase un objeto un puntero a la interfaz de su sitio.

Sintaxis

HRESULT SetSite(
  [in] IUnknown *pUnkSite
);

Parámetros

[in] pUnkSite

Puntero al puntero de interfaz IUnknown del sitio que administra este objeto. Si es NULL, el objeto debe llamar a Release en cualquier sitio existente en el que el objeto ya no conoce su sitio.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente.

Comentarios

El objeto debe contener este puntero, llamando a IUnknown::AddRef al hacerlo. Si el objeto ya tiene un sitio, debe llamar a IUnknown::Release del sitio existente, guardar el nuevo puntero de sitio y llamar al IUnknown::AddRef del sitio nuevo.

no se permite E_NOTIMPL. Sin la implementación del método SetSite , la interfaz IObjectWithSite no es necesaria.

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