Forces selected links to connect to their source and retrieve current information.
HRESULT UpdateLink(
DWORD dwLink, //Unique 32-bit link identifier
DWORD fErrorMessage, //Determines whether or not caller should
// display error message
DWORD fReserved //Reserved
);
This method supports the standard return values E_FAIL, E_INVALIDARG, and E_OUTOFMEMORY, as well as the following:
Call this method with fErrorMessage set to TRUE in cases where the user expressly presses a button to have a link updated, that is, presses the Links' Update Now button. Call it with FALSE in cases where the container should never display an error message, that is, where a large set of operations are being performed and the error should be propagated back to the user later, as might occur with the Update links progress meter. Rather than providing one message for each failure, assuming there are failures, provide a single message for all failures at the end of the operation.
For OLE links, call IOleObject::Update.
Windows NT: Use version 3.1 or later.
Windows: Use Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in oledlg.h.