Metodo IOleUILinkContainerA::UpdateLink (oledlg.h)

Forza i collegamenti selezionati per connettersi all'origine e recuperare le informazioni correnti.

Sintassi

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

Parametri

[in] dwLink

Identificatore univoco definito dal contenitore per un singolo collegamento. I contenitori possono usare il puntatore al sito del contenitore del collegamento per questo valore.

[in] fErrorMessage

Determina se il chiamante (implementer di IOleUILinkContainer) deve visualizzare un messaggio di errore in caso di errore durante l'aggiornamento di un collegamento. La finestra di dialogo Aggiorna collegamenti imposta questa proprietà su FALSE. Le finestre di dialogo Proprietà oggetto e Collegamenti lo impostano su TRUE.

[in] fReserved

Questo parametro è riservato e deve essere impostato su FALSE.

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_ACCESSDENIED	Autorizzazioni di accesso insufficienti.
E_FAIL	Operazione non riuscita.
E_INVALIDARG	L'identificatore specificato non è valido.
E_OUTOFMEMORY	Memoria insufficiente per questa operazione.

Commenti

Note ai chiamanti

Chiamare questo metodo con fErrorMessage impostato su TRUE nei casi in cui l'utente preme espressamente un pulsante per avere un collegamento aggiornato, ovvero preme il pulsante Aggiorna ora dei collegamenti. Chiamarlo con FALSE nei casi in cui il contenitore non dovrebbe mai visualizzare un messaggio di errore, ovvero in cui viene eseguito un ampio set di operazioni e l'errore deve essere propagato all'utente in un secondo momento, come potrebbe verificarsi con il contatore dello stato di avanzamento dei collegamenti di aggiornamento . Anziché fornire un messaggio per ogni errore, supponendo che si verifichino errori, fornire un singolo messaggio per tutti gli errori alla fine dell'operazione.

Note per gli implementatori

Per i collegamenti OLE, chiamare IOleObject::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	oledlg.h

Vedi anche

IOleObject::Update

IOleUILinkContainer