OleCreateLink

Creates an OLE compound-document linked object.

WINOLEAPI OleCreateLink(

LPMONIKER pmkLinkSrc,

//Pointer to moniker indicating source of linked object

REFIID riid,

//Reference to the identifier of the interfacer to be used to communicate with the new object

DWORD renderopt,

//Value from OLERENDER

LPFORMATETC pFormatEtc,

//Pointer to a FORMATETC structure

LPOLECLIENTSITE pClientSite,

//Pointer to an interface

LPSTORAGE pStg,

//Pointer to the object’s storage

LPVOID FAR* ppvObj

//Indirect pointer to the interface requested in riid

);

Parameters

pmkLinkSrc: [in] Pointer to the IMoniker interface on the moniker that can be used to locate the the source of the linked object.
riid: [in] Reference to the identifier of the interface the caller later uses to communicate with the new object (usually IID_IOleObject, defined in the OLE headers as the interface identifier for IOleObject).
renderopt: [in] 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 Remarks section below.
pFormatEtc: [in] Pointer to 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: [in] Pointer to an instance of IOleClientSite, the primary interface through which the object will request services from its container. May be NULL.
pStg: [in] Pointer to the IStorage interface on the storage object. This parameter may not be NULL.
ppvObj: [out] Indirect pointer to the interface requested in riid on the newly created object.

Return Values

S_OK: The compound-document linked object was created successfully.
OLE_E_CANT_BINDTOSOURCE: Not able to bind to source. Binding is necessary to get the cache’s initialization data.

Remarks

Call OleCreateLink to allow a container to create a link to an object.

LPMONIKER pmkLinkSrc,	//Pointer to moniker indicating source of linked object
REFIID riid,	//Reference to the identifier of the interfacer to be used to communicate with the new object
DWORD renderopt,	//Value from OLERENDER
LPFORMATETC pFormatEtc,	//Pointer to a FORMATETC structure
LPOLECLIENTSITE pClientSite,	//Pointer to an interface
LPSTORAGE pStg,	//Pointer to the object’s storage
LPVOID FAR* ppvObj	//Indirect pointer to the interface requested in riid
);