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