OleCreateLink

Creates an OLE compound-document linked object.

HRESULT OleCreateLink(

LPMONIKER pmkLinkSrc,
//Points to IMoniker instance indicating source of linked object
REFIID riid,
//Interface to be used to communicate with the new object
DWORD renderopt,
//Value from OLERENDER
LPFORMATETC pFormatEtc,
//FORMATETC value depending on renderopt value
LPOLECLIENTSITE pClientSite,
//Pointer to an instance of IOleClientSite
LPSTORAGE pStg,
//Pointer to an IStorage instance used as the object storage
LPVOID FAR* ppvObj
//Receives a pointer to the interface requested in riid
);

Parameters

pmkLinkSrc

Points to an IMoniker interface instance that indicates the source of the linked object.

riid

Identifies the interface the caller later uses to communicate with the new object (usually IID_IOleObject).

renderopt

Specifies a value from the enumeration OLERENDER that indicates the locally cached drawing or data-retrieval capabilities the newly created object is to have. Additional considerations are described in the Comments section below.

lpFormatEtc

Specifies a value from the enumeration OLERENDER that indicates the locally cached drawing or data retrieval capabilities the newly created object is to have. The OLERENDER value chosen affects the possible values for the pFormatEtc parameter.

pClientSite

Points to an instance of IOleClientSite, the primary interface through which the object will request services from its container. May be NULL.

pStg

Points to an instance of the IStorage interface to be used as the storage for the object. This parameter may not be NULL.

ppvObj

Receives a pointer to the interface requested in riid on the newly created object on return.

Return Values

S_OK

Indicates the compound-document linked object was created successfully.

OLE_E_CANT_BINDTOSOURCE

Indicates not able to bind to source. Binding is necessary to get the cache's initialization data.

Comments

Call OleCreateLink whenever a container creates a linked object within itself.

See Also

IOleObject::SetMoniker, IOleClientSite::GetMoniker

Software for developers
Delphi Components
.Net Components
Software for Android Developers
More information resources
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
Databases for Amazon shops developers
Amazon Categories Database
Browse Nodes Database