Método IOleObject::GetClientSite (oleidl.h)

Recupera un puntero al sitio de cliente de un objeto incrustado.

Sintaxis

HRESULT GetClientSite(
  [out] IOleClientSite **ppClientSite
);

Parámetros

[out] ppClientSite

Dirección de la variable de puntero IOleClientSite que recibe el puntero de interfaz al sitio cliente del objeto. Si un objeto aún no conoce su sitio de cliente o si se ha producido un error, ppClientSite debe establecerse en NULL. Cada vez que un objeto recibe una llamada a IOleObject::GetClientSite, debe aumentar el recuento de referencias en ppClientSite. Es responsabilidad del autor de la llamada llamar a Release cuando se realiza con ppClientSite.

Valor devuelto

Este método devuelve S_OK cuando funciona correctamente.

Comentarios

Los clientes de vínculo suelen llamar al método IOleObject::GetClientSite junto con el método IOleClientSite::GetContainer para atravesar una jerarquía de objetos anidados. Un cliente de vínculo llama a IOleObject::GetClientSite para obtener un puntero al sitio cliente del origen del vínculo. A continuación, el cliente llama a IOleClientSite::GetContainer para obtener un puntero al contenedor del origen del vínculo. Por último, el cliente llama a QueryInterface para obtener IOleObject e IOleObject::GetClientSite para obtener el sitio cliente del contenedor dentro de su contenedor. Al repetir esta secuencia de llamadas, el autor de la llamada puede recuperar finalmente un puntero al contenedor maestro en el que se anidan todos los demás objetos.

Notas a los autores de llamadas

El puntero de sitio de cliente devuelto será NULL si aún no se ha informado a un objeto incrustado de su sitio cliente. Este será el caso con un objeto recién cargado o creado cuando un contenedor ha pasado un puntero de sitio de cliente NULL a una de las funciones auxiliares de creación de objetos, pero aún no ha llamado A IOleObject::SetClientSite como parte de la inicialización del objeto.

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	oleidl.h

Consulte también

IOleObject

IOleObject::SetClientSite