Share via


Metodo IObjectWithSite::SetSite (ocidl.h)

Consente a un contenitore di passare un oggetto un puntatore all'interfaccia per il relativo sito.

Sintassi

HRESULT SetSite(
  [in] IUnknown *pUnkSite
);

Parametri

[in] pUnkSite

Puntatore al puntatore all'interfaccia IUnknown del sito che gestisce questo oggetto. Se NULL, l'oggetto deve chiamare Release in qualsiasi sito esistente a cui l'oggetto non conosce più il sito.

Valore restituito

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

Commenti

L'oggetto deve contenere questo puntatore, chiamando IUnknown::AddRef in questo modo. Se l'oggetto ha già un sito, deve chiamare il sito esistente IUnknown::Release, salvare il nuovo puntatore del sito e chiamare il nuovo sito IUnknown::AddRef del nuovo sito.

E_NOTIMPL non è consentito. Senza l'implementazione del metodo SetSite , l'interfaccia IObjectWithSite non è necessaria.

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

Vedi anche

IObjectWithSite