Metodo IOleObject::GetClientSite (oleidl.h)

Recupera un puntatore al sito client di un oggetto incorporato.

Sintassi

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

Parametri

[out] ppClientSite

Indirizzo della variabile puntatore IOleClientSite che riceve il puntatore dell'interfaccia al sito client dell'oggetto. Se un oggetto non conosce ancora il sito client o se si è verificato un errore, ppClientSite deve essere impostato su NULL. Ogni volta che un oggetto riceve una chiamata a IOleObject::GetClientSite, deve aumentare il conteggio dei riferimenti in ppClientSite. È responsabilità del chiamante chiamare Release quando viene eseguita con ppClientSite.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo.

Commenti

I client di collegamento in genere chiamano il metodo IOleObject::GetClientSite insieme al metodo IOleClientSite::GetContainer per attraversare una gerarchia di oggetti annidati. Un client di collegamento chiama IOleObject::GetClientSite per ottenere un puntatore al sito client dell'origine del collegamento. Il client chiama quindi IOleClientSite::GetContainer per ottenere un puntatore al contenitore dell'origine del collegamento. Infine, il client chiama QueryInterface per ottenere IOleObject e IOleObject::GetClientSite per ottenere il sito client del contenitore all'interno del contenitore. Ripetendo questa sequenza di chiamate, il chiamante può infine recuperare un puntatore al contenitore master in cui vengono annidati tutti gli altri oggetti.

Note ai chiamanti

Il puntatore del sito client restituito sarà NULL se un oggetto incorporato non è ancora stato informato del sito client. Ciò avvierà con un oggetto appena caricato o creato quando un contenitore ha passato un puntatore del sito client NULL a una delle funzioni helper di creazione di oggetti, ma non ha ancora chiamato IOleObject::SetClientSite come parte dell'inizializzazione dell'oggetto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleidl.h

Vedi anche

Ioleobject

IOleObject::SetClientSite