# IOleUILinkContainer

The IOleUILinkContainer interface is implemented by containers and used by OLE common dialog boxes. It supports these dialog boxes by providing the methods needed to manage a container’s links.

The IOleUILinkContainer methods enumerate the links associated with a container, and specify how they should be updated, automatically or manually. They change the source of a link and obtain information associated with a link. They also open a link’s source document, update links, and break a link to the source.

##### When to Implement

You must implement this interface if you are creating a container application that will use the Links, Change Source, or Update Links dialog boxes, as well as the Object Properties dialog box, which uses this interface indirectly. The Links dialog box calls back to the container application to perform OLE functions that manipulate the links within the container.

##### When to Use

OLE common dialog boxes use only this interface to manage the properties of a container’s links. They can also use it to manage non-OLE (DDE and other container-specific) links.

Methods in Vtable Order

IUnknown Methods | Description
QueryInterface | Returns a pointer to a specified interface.
AddRef | Increments the reference count.
Release | Decrements the reference count.

IOleUILinkContainer Methods | Description
GetNextLink | Enumerates the links in the container.
SetLinkUpdateOptions | Sets update options.
GetLinkUpdateOptions | Determines current update options for the link.
SetLinkSource | Changes the source of the link.
GetLinkSource | Returns Links dialog box information about the link.
OpenLinkSource | Opens a link’s source.
UpdateLink | Forces a link to connect to its source and update.
CancelLink | Disconnects selected links.

See Also

OleUIEditLinks, OleUIChangeSource, OleUIUpdateLinks, OleUIObjectProperties, OLEUIEDITLINKS