Metodo IOleObject::Update (oleidl.h)

Aggiornamenti i dati o le cache di visualizzazione di un gestore di oggetti o di collegamento.

Sintassi

HRESULT Update();

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
E_FAIL	Operazione non riuscita.
OLE_E_CANT_BINDTOSOURCE	Impossibile eseguire l'oggetto per ottenere dati aggiornati. L'oggetto è per qualche motivo non disponibile per il chiamante.
CACHE_E_NOCACHE_UPDATED	Nessuna cache aggiornata.
CACHE_S_SOMECACHES_NOTUPDATED	Alcune cache non sono state aggiornate.

Commenti

Il metodo Update consente ai contenitori di mantenere aggiornati i dati nei relativi oggetti collegati e incorporati. Un oggetto collegamento può diventare obsoleto se l'origine del collegamento è stata aggiornata. Un oggetto incorporato che contiene collegamenti ad altri oggetti può diventare obsoleto. Un oggetto incorporato che non contiene collegamenti non può diventare obsoleto perché i dati non sono collegati a un'altra origine.

Note per gli implementatori

Quando un contenitore chiama il metodo IOleObject::Update di un oggetto collegamento, l'oggetto collegamento trova l'origine del collegamento e ottiene una nuova presentazione. Questo processo può comportare anche l'esecuzione di una o più applicazioni oggetto, che potrebbero richiedere molto tempo.

Quando un contenitore chiama il metodo IOleObject::Update di un oggetto incorporato, richiede all'oggetto di aggiornare tutti gli oggetti di collegamento che può contenere. In risposta, il gestore dell'oggetto chiama in modo ricorsivo IOleObject::Update per ognuno dei propri oggetti collegati, eseguendo ognuno in base alle esigenze.

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::IsUpToDate