Index   Commented   Search   About

IOleUILinkContainer::CancelLink

Disconnects the selected links.

HRESULT CancelLink(

DWORD dwLink
//Unique 32-bit link identifier
);

Parameter

dwLink

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

Return Values

S_OK

Successfully disconnected the selected links.

E_FAIL

Unable to disconnect the selected links.

E_INVALIDARG

One or more invalid arguments.

E_OUTOFMEMORY

Insufficient memory.

E_ACCESSDENIED

Insufficient access permissions.

Comments

Notes To Callers

Call CancelLink when the user selects the Break Link button from the Links dialog. The link should be converted to a picture. The Links dialog will not be dismissed for OLE links.

Notes To Implementors

For OLE links, OleCreateStaticFromData can be used to create a static picture object using the IDataObject interface of the link as the source.

See Also

IDataObject, OleCreateStaticFromData

Related Links

Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder

More Online Helps

Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008 Free Tect Secrets ;) greatis just4fun network just4fun