Metodo IOleLink::Update (oleidl.h)

Aggiornamenti i dati memorizzati nella cache del documento composto per un oggetto collegato. Ciò comporta l'associazione all'origine del collegamento, se non è già associata.

Sintassi

HRESULT Update(
  [in] IBindCtx *pbc
);

Parametri

[in] pbc

Puntatore all'interfaccia IBindCtx nel contesto di associazione da usare nell'associazione dell'origine collegamento. Questo parametro può essere NULL. Il contesto di associazione memorizza nella cache gli oggetti associati durante il processo di associazione, contiene parametri che si applicano a tutte le operazioni usando il contesto di associazione e fornisce i mezzi in base al quale l'implementazione dell'associazione deve recuperare informazioni sull'ambiente. Per altre informazioni, vedere IBindCtx.

Valore restituito

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

Codice restituito Descrizione
CACHE_E_NOCACHE_UPDATE
L'operazione di associazione ha funzionato, ma non sono state aggiornate cache.
CACHE_S_SOMECACHES_NOTUPDATED
L'operazione di associazione ha funzionato, ma non tutte le cache sono state aggiornate.
OLE_E_CANT_BINDTOSOURCE
Impossibile eseguire l'associazione all'origine del collegamento.

Commenti

Note ai chiamanti

L'applicazione contenitore deve chiamare Update se l'utente finale aggiorna i dati memorizzati nella cache per un oggetto collegato.

L'utente finale può aggiornare i dati memorizzati nella cache per un oggetto collegato scegliendo il pulsante Aggiorna ora nella finestra di dialogo Collegamenti . Se si usa la funzione OleUIEditLinks per visualizzare la finestra di dialogo Collegamenti , è necessario implementare l'interfaccia IOleUILinkContainer . La finestra di dialogo chiama le implementazioni di IOleUILinkContainer::UpdateLink quando l'utente finale sceglie il pulsante Aggiorna ora . L'implementazione di tale metodo può chiamare Update.

L'applicazione contenitore può anche chiamare Update per aggiornare un oggetto collegato, perché tale metodo chiama Update quando viene chiamato su un oggetto collegato.

Questo metodo aggiorna sia collegamenti automatici che collegamenti manuali. Per i collegamenti manuali, chiamare Update o Update è l'unico modo per aggiornare le cache. Per altre informazioni sui collegamenti automatici e manuali, vedere IOleLink::SetUpdateOptions.

Note sull'implementazione

Se pbc non è NULL, l'implementazione dell'oggetto collegato di Update chiama IBindCtx::RegisterObjectBound per registrare l'origine collegamento associata. Ciò garantisce che l'origine collegamento rimanga in esecuzione finché non viene rilasciato il contesto di associazione.

Le cache correnti vengono lasciate intatte se l'origine del collegamento non può essere associata.

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

IBindCtx::RegisterObjectBound

IOleLink

IOleLink::SetUpdateOptions

IOleLink::Update

IOleUILinkContainer

OleUIEditLinks