EN
Dieser Inhalt ist in Ihrer Sprache leider nicht verfügbar. Im Folgenden finden Sie die englische Version.

IOleUILinkContainer::UpdateLink method

Forces selected links to connect to their source and retrieve current information.

Syntax


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

Parameters

dwLink [in]

Container-defined unique identifier for a single link. Containers can use the pointer to the link's container site for this value.

fErrorMessage [in]

Determines whether the caller (implementer of IOleUILinkContainer) should show an error message upon failure to update a link. The Update Links dialog box sets this to FALSE. The Object Properties and Links dialog boxes set it to TRUE.

fReserved [in]

This parameter is reserved and must be set to FALSE.

Return value

This method returns S_OK on success. Other possible return values include the following.

Return codeDescription
E_ACCESSDENIED

Insufficient access permissions.

E_FAIL

The operation failed.

E_INVALIDARG

The specified identifier is invalid.

E_OUTOFMEMORY

There is insufficient memory available for this operation.

 

Remarks

Notes to Callers

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.

Notes to Implementers

For OLE links, call IOleObject::Update.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

OleDlg.h

IID

IID_IOleUILinkContainer is defined as 000004FF-0000-0000-C000-000000000046

See also

IOleUILinkContainer
IOleObject::Update

 

 

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft