Metodo IOleLink::SetUpdateOptions (oleidl.h)

Articolo
03/01/2024

Specifica la frequenza con cui un oggetto collegato deve aggiornare i dati memorizzati nella cache.

Sintassi

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

Parametri

[in] dwUpdateOpt

Specifica la frequenza con cui un oggetto collegato deve aggiornare i dati memorizzati nella cache. I valori possibili per dwUpdateOpt sono tratti dall'enumerazione OLEUPDATE.

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_INVALIDARG	Il valore fornito non è valido.

Commenti

Note ai chiamanti

L'applicazione contenitore deve chiamare IOleLink::SetUpdateOptions quando l'utente finale modifica l'opzione di aggiornamento per un oggetto collegato.

L'utente finale seleziona l'opzione di aggiornamento per un oggetto collegato usando la finestra di dialogo Collegamenti . Se si usa la funzione OleUIEditLinks per visualizzare questa finestra di dialogo, è necessario implementare l'interfaccia IOleUILinkContainer . La finestra di dialogo chiama il metodo IOleUILinkContainer::SetLinkUpdateOptions per specificare l'opzione di aggiornamento scelta dall'utente finale. L'implementazione di questo metodo deve chiamare il metodo IOleLink::SetUpdateOptions per passare l'opzione selezionata all'oggetto collegato.

Note per gli implementatori

L'opzione di aggiornamento predefinita è OLEUDPATE_ALWAYS. L'implementazione dell'oggetto collegato di IPersistStorage::Save salva l'opzione di aggiornamento corrente.

Se OLEUDPATE_ALWAYS viene specificata come opzione di aggiornamento, l'oggetto collegato aggiorna le cache del collegamento nelle situazioni seguenti:

Quando l'opzione di aggiornamento viene modificata da manuale a automatica, se l'origine del collegamento è in esecuzione.
Ogni volta che l'oggetto collegato viene associato all'origine del collegamento.
Ogni volta che l'origine del collegamento è in esecuzione e vengono chiamate le implementazioni IOleObject::Close, IPersistStorage::Save o IAdviseSink::OnSave dell'oggetto collegato.

Per i collegamenti manuali e automatici, l'oggetto collegato aggiorna la cache ogni volta che l'applicazione contenitore chiama IOleObject::Update o IOleLink::Update.

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