Metodo IOleObject::IsUpToDate (oleidl.h)

Controlla se un oggetto è aggiornato.

Sintassi

HRESULT IsUpToDate();

Valore restituito

Questo metodo restituisce S_OK se l'oggetto è aggiornato; in caso contrario, S_FALSE. Gli altri valori restituiti possibili includono i seguenti:

Codice restituito	Descrizione
OLE_E_UNAVAILABLE	Lo stato dell'oggetto non può essere determinato in modo tempestivo.

Commenti

Il metodo IOleObject::IsUpToDate consente ai contenitori di controllare in modo ricorsivo se tutti gli oggetti sono aggiornati. Ovvero, quando il contenitore chiama questo metodo sul primo oggetto, l'oggetto lo chiama a sua volta per tutti i propri oggetti e a sua volta per tutti i relativi oggetti, fino a quando tutti gli oggetti non sono stati controllati.

Note per gli implementatori

A causa della natura ricorsiva di IOleObject::IsUpToDate, determinare se un oggetto non è aggiornato, in particolare uno contenente uno o più oggetti, può richiedere molto tempo, come semplicemente aggiornare l'oggetto in primo luogo. Se si preferisce evitare query lunghe di questo tipo, assicurarsi che IOleObject::IsUpToDate restituisca OLE_E_UNAVAILABLE. Nei casi in cui l'oggetto su cui eseguire query è piccolo e non contiene oggetti stessi, rendendo quindi possibile una query efficiente, questo metodo può restituire S_OK o S_FALSE.

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